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NAME 

README - introduction to Pixar Manual Pages 

DESCRIPTION 

Welcome to the Pixar man pages. We have tried to match this book to the Pixar Software Release 1.2 and 

make it easy to use. It is modeled on the UNIX documentation for man pages. Each man page describes 

one or more routines related to each other. Use the permuted index to find the page that holds a specific 

routine. Here are some notes on general use of the Pixar man pages. 

Tabs You will find two kinds of tabs to help divide the tradition UNIX sections into subsections. The 
major tabs have the familiar meaning, while the minor tabs correspond to subsections (e.g., 
libraries, etc.). 

Paper Grey paper denotes material (table of contents, permuted index, etc.) that will direct you to the 
pages in each section. The pink pages at the end of the book are for your comments. 

Dates Each manual page bears its own date of last revision on the bottom. 

Paths Pixar manual pages are located in /usr/pixar/man. To get on-line manual help (man) for xxxx, 
type: 

man -P /usr/pixar/man xxxx 
Or you can save typing by using: 

alias pixman "man -P /usr/pixar/man" 

Then simply type: 
pixman xxxx 

(The above alias can also be put in the .cshrc file in your home directory to have the pixman com¬ 
mand available permanently.) 

Bugs Mail in the pink comment forms, or use electronic mail to submit on-line comments and sugges¬ 
tions (e.g., mail pixar/bugs ). 

Note Copyright 1986 by Pixar. This document is protected by Federal Copyright Law, with all rights 
reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmit¬ 
ted, in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, 
without prior written permission from Pixar. 

The information in this manual is for informational purposes only and is subject to change without 
notice. Use, duplication or disclosure by the Government is subject to restrictions as set forth in 
subdivision (b) (3) (ii) of the Rights in Technical Data and Computer Software clause at 252.227- 
7013. 
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- Chap link editor..chld(l) 

- read/write Chap Mbus devices.libpixar:ChapMbus(3H) 

- print name list of a Chap object file.chnm(l) 

-size of a Chap object file.. chsize(l) 

-download a Chap object file and start it running.chload(l) 

-compare a Chap object file to die downloaded version.. chcmp(l) 

- introduction to Chap Pixel Transfer Library.libpt:libpt(3C) 

- convert archives to Chap random libraries.chranlib(l) 

-write/read Chap resources.libchad:ChadWrite(3H) 

- introduction to Pixar library of general-purpose Chap routines.libpg:libpg(3C) 

-read/write Chaprunflagstate. .libpixarChapStack(3H) 

- Chap runtime control.libpixar:ChapRun(3H) 

- Chap runtime monitor. .charm(l) 

- Chap runtime symbol table.chapsym(5) 

-read/write ChapSbusdevice. .libpixar:ChapSbus(3H) 

> -fill each Chap scratchpad memory with its address.libpixanChapSpad(3H) 

-display Chap symbol table...chmap(l) 

— Chap symbol table routines.libpixanChapSym(3H) 

- Chap sysbus register routines.libpixanChapReg(3H) 

- Draw lines in a pixel window and set line characteristics.libpirl:PirlLine(3H) 

-Pixarsystemdiagnostc check.Diagnostic(8) 

- compute a Cyclic Redundency Check (CRQ on a framebuffer. . . . ..crc(l) 

- performs a Cyclic Redundency Check (CRQ on a pixel window.libpip:PWCrc(3Q 

- performs a Cyclic Redundency Check (CRQ on a pixel window.. libpirl:PirlCrc(3H) 

- performs a Cyclic Redundency Check (CRQ on a scanline in scratchpad..libpip:SSCrc(3Q 

- convert red-green-blue values to CIE coordinates.libcolonrgb2xyY(3C) 

- convert red-green-blue values to unnormalized CIE coordinates.libcolonrgb2XYZ(3C) 

- convert unnormalized CIE coordinates to red-green-blue values.libcolonXYZ2rgb(3C) 

- circular shift pixel window contents in x and/or y.libpirl: PiriShift(3H) 

- circular shift pixel window contents in x and/or y.libpt:PWShift(3Q 

pixel window. - clamp pixel between 0.0(G) and 1.0 (0x800) for a. libpiri:PirlClamp(3H) 

pixel window. - clamp pixel between 0.0(0) and 1.0 (0x800) for a.libpt:PWClamp(3C) 

- clamp pixel values to the range [0,1.0E].. . libcolonSSClamp(3Q 

- clamp the contents of a framebuffer to [0..2048].clamp(l) 

- cleans out the tile block area.libpt:TB(3Q 

-framebuffer clear. .clr(l) 

- clear an integer array to a single channel value..libpt:SICopy(3Q 

-set and clear Chap breakpoints.libpixar:ChapBpt(3H) 

component value. - clear frame buffer in increasing y order to a .libpt:CFCopy(3Q 

- clear partial vertical scanline in frame buffer..Iibpt:SFCopy(3C) 

- clear pixel window to color. .libpirl: PirlClear(3H) 

- clear pixel window to color .libpt:PWClear(3C) 

- close a picture file.libpicio:PicClose(3H) 

- set up filter coefficients for subsequent hd 1 or vdl.libpx:SSScale(3Q 

-display color bars. ..libpiri:PiriCbars(3H) 

a single component through a color table to form a color image, -map . . . ..libpip:PWMap(3Q 

a single component through a color table to form a color image, -map.. . libpiri:PirlMapComp(3H) 

- get/set the video controller color map. ... libpixan VideoCmap(3 H) 

one channel from scratchpad to 4 channels through a color table. /SSBtoRGBALUT, SSAtoRGBALUT: Copy . . libpt:SSCopyRGBALUT(3Q 
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Permuted Index 


- map a single component through a 

- map a single component through a 

- video 

- set gamma-corrected 

- introduction to Pixar 

version. - 
-Chap 

- accumulate histogram of input 

increasingyorder, -copy 
image, - map a single 
image, - map a single 
- clear frame buffer in increasing y order to a 

- remap 4 

- remap 4 

- shuffle 

- shuffle 

framebuffer. - 
unsigned 32-bit double-precision fraction. - 
32-bit integer. - 
pixel window.. - 
window.. - 

numbers. - 

- get/set Chap 

- initialize the pixar and the 

- Chap 

- circular shift pixel window 

- circular shift pixel window 

- clamp the 

- Chap runtime 
- open/close a video 

- set/clear options of a memory 

- get/set the video 

- set the location of a video 

- setup a memory 
-Pixar memory 

- Pixar video 

- get/set video 

- set video 


coordinates. - 
red-green-blue values. - 


kernel. - 
kernel. - 

- convert red-green-blue values to CIE 
convert red-green-blue values to unnormalized CIE 
- convert unnormalized CIE 
buffer memory. - 
increasing y order. - 
SSRtoRGBA, SSGtoRGBA, SSBtoRGBA, SSAtoRGBA: 
/SSGtoRGBALUT, SSBtoRGBALUT, SSAtoRGBALUT: 

channel. SSRRRRtoRRRR,...: 

to frame buffer IFyCopy - copy partial/ IFxCopy: 

scratchpad. - 
scratchpad. - 
buffer to scratchpad. - 
integer/ /integer array to frame buffer IFyCopy - 


array. - 


color table to form a color image. 

color table to form a color image. 

colorbar generator. . 

colormap.. 

color-transformation library. 

Combine two images.. 

compare a Chap object file to the downloaded . . 

compare scanline pixel buffers in scratchpad. . . 

compiler.. 

component array. 

component from scratchpad to frame buffer in . . 
component through a color table to form a color 
component through a color table to form a color 

component value. 

components of a pixel window. ......... 

components of a pixel window. 

components of each pixel for a pixel window.. . . 

components of each pixel for a pixel window.. . . 

composite a foreground with a background. . . . 
compute a Cyclic Redundency Check (CRC) on a . 
compute approximate 4-way reciprocal square root of 
compute approximate 4-way square root of unsigned 
compute new pixel = a*pixel+6 for a ...... 

compute new pixel * pixel-6 for a pixel. 

compute the histogram of a pixel window. .... 
computes 2‘32/n of four non-negative 32-bit . . . 

configuration information. 

configuration tables. 

configuration tool. 

contents in x and/or y. 

contents in x and/or y. 

contents of a framebuffer to [0..2048]. 

control. 

controller. . ... 

controller. 

controller color map. . 

controller cursor... 

controller device for diagnostic use. ...... 

controller device interface. 

controller device interface. 

controller display format. . 

controller display state. 

convert archives to Chap random libraries. 

convert red-green-blue values to CIE coordinates. . 
convert red-green-blue values to unnormalized CIE 
convert unnormalized CIE coordinates to .... 
convolve a framebuffer image with a 3x3 filter. . . 
convolve a pixel window with a 1-d kernel. . . . 
convolve pixel window buffer with 1-d pulse (box), 
convolve pixel window buffer with 1-d pulse (box). 

convolve pixel window with 3x3 filter. . 

convolve pixel window with 3x3 separable filter. 

convolve pixel window with a 1-d kernel. 

convolve pixel window with a 3x3 kernel. 

convolve scratchpad buffer with 1-d kernel. . . . 
convolve scratchpad buffer with 1-d pulse (box), 
convolve scratchpad buffers with 3x3 kernel. . . . 
convolve scratchpad buffers with 3x3 separable . . 
convolve scratchpad buffers with 5x5 separable . . 

coordinates. .. 

coordinates. -. 

coordinates to red-green-blue values. 

copy a single tile between locations in frame . . . 
copy component from scratchpad to frame buffer in 
Copy one channel from scratchpad to 4 channels. . 
Copy one channel from scratchpad to 4 channels/ . 
Copy one channel from scratchpad to another . . 
copy one scanline repeatedly into a pixel window. . 
copy partial scanline from scratchpad integer array 

copy partial scanline from scratchpad to. 

copy partial scanline from scratchpad to. 

copy partial vertical scanline backwards from frame 
copy partial vertical scanline from scratchpad . . 
copy runlength array to scratchpad pixel array. . . 
copy scratchpad channel array to runlength array. . 
copy scratchpad integer array to scratchpad integer 


libpip:PWMap(3C) 
libpirl: PirlMapComp(3H) 
cbars(l) 
gamma(l) 

libcolor:libcolor(3C) 

libpt:SSComb(3C) 

chcmp(l) 

libpt:SSCompare(3C) 

chc(l) 

libpip:dhg(3C) 

Iibpt:RGBAFCopy(3C) 

libpip:PWMap(3C) 

libpirl:PirlMapComp(3H) 

libpt:CFCopy(3C) 

libpirl:PirlMap(3H) 

libpt:PW4Map(3Q 

libpirl:PirlShuffle(3H) 

libpt:PWShuffle(3C) 

libpirl:Pir!Merge(3H) 

crc(l) 

libpm:recsqrt(3C) 

libpm:sqrt(3C) 

libpt:PWAxb(3C) 

libpirl:PiriAxb(3H) 

libpip:PWHistogram(3C) 

libpm:reciprocal(3C) 

libpixar:ChapConfig(3H) 

pixinit(l) 

chconfig(8) 

libpirl:PirlShift(3H) 

libpt:PWShift(3C) 

clamp(l) 

libpixar:ChapRun(3H) 

libpixarVideoOpen(3H) 

mctrl(8) 

libpixanVideoCmap(3H) 

libpixanVideoCursor(3H) 

libpixar:MctrlOpen(3H) 

mctrl(4) 

video(4) 

libpixar:VideoFormat(3H) 

libpixar:VideoDisplay(3H) 

chranlib(l) 

libcolor.rgb2xy Y (3C) 

libcolor:rgb2XYZ(3C) 

libcolor:XYZ2rgb(3C) 

conv(l) 

libpiri:PirlConvolve(3H) 

libpip:PWBoxFilter(3C) 

libpirl:PirlBoxFilter(3H) 

libpip:PWc33(3C) 

libpip:PWc33s(3C) 

libpip:PWConv(3C) 

libpirl:PirlConvolve3x3(3H) 

libpip:SSConv(3Q 

libpip:SSBoxFilter<3C) 

libpip:C33(3C) 

libpip:C33s(3C) 

libpip:C55s(3C) 

libcolonrgb2xy Y (3C) 

libcolorrgb2XYZ(3C) 

libcolor:XYZ2rgb(3C) 

libpt:TBCopy(3Q 

libpt:RGBAFCopy(3C) 

libpt:SSCopyRGBA(3C) 

libpt:SSCopyRGBALUT(3C) 

Iibpt:SSCopyComp(3C) 

libpirl:PirlSweep(3H) 

libpt:IFCopy(3C) 

libpt:SCCopy(3Q 

libpt:SSCopy(3C) 

libpt:FSCopy(3C) 

libpt:IFCopy(3Q 

libpt:RSCopy(3Q 

libpt:CRCopy(3Q 

libpt:CICopy(3C) 
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Permuted Index 


pixel window. - copy the source pixel window to the destination .libpirl:PirlResize(3H) 

- copy utility for portions of the framebuffer. .copy(l) 

channel to spad channel array. - copy vertical scanline backwards from alpha fb.libpt:FCCopy(3C) 

channel to spad integer array. - copy vertical scanline backwards from alpha fb.libpt:FICopy(3Q 

spad channel array. - copy vertical scaniine from arbitrary fb channel to.libpt:FRGBACopy(3Q 

- compute a Cyclic Redundency Check (CRQ on a framebuffer....crc(l) 

- performs a Cyclic Redundency Check (CRQ on a pixel window.libpip:PWCrc(3C) 

- performs a Cyclic Redundency Check (CRC) on a pixel window.libpirl:PirlCrc(3H) 

- performs a Cyclic Redundency Check (CRQ on a scanline in scratchpad.. libpip:SSCre(3Q 

- create/open a picture file.libpicio:PicCreat(3H) 

- read/write Chap crossbar state.libpixanChapXbar(3H) 

- set the location of a video controller cursor..libpixar:VideoCursor(3H) 

-compute a Cyclic Redundency Check (CRQ on a framebuffer..crc(l) 

- performs a Cyclic Redundency Check (CRQ on a pixel window.libpip:PWCrc(3Q 

- performs a Cyclic Redundency Check (CRQ on a pixel window. .... libpirl:PirlCrc(3H) 

scratchpad. - performs a Cyclic Redundency Check (CRQ on a scanline in .libpip:SSCrc(3C) 

- sequential decoding of tile from disk.libpicio:PicDecode(3H) 

-routines for defining and getting framebuffer definitions.. . libg:fbgetdef(3H) 

-framebufferdescription definitions...fbdefs(7) 

- routines for defining and getting framebuffer definitions.. ..libg:fbgetdef(3H) 

- describe an error by Chad. ..libchad:ChadErrReport(3H) 

- framebuffer description definitions.fbdefs(7) 

error. - print a descriptive error message explaining the last.libpirl:PirlErrReport(3H) 

- copy the source pixel window to the destination pixel window. ..libpirl:PirlResize(3H) 

- swap the source pixel window and the destination pixel window..libpirii:PirlSwap(3H) 

- swap the source pixel window and the destination pixel window...libpt:PWSwap(3C) 

- resize source pixel window to destination pixel window.libpx:PWResize(3C) 

: PIXAR special filename determination routines.libchad:getdevs(3H) 

image. - determine the smallest rectangle that surrounds an.. libpip:PWBBox(3Q 

image. - determine the smallest rectangle that surrounds an.libpirl:PirlBBox(3H) 

- read a Chap Abus device.libpixanChapAbus(3H) 

- open/close a Chap device.libpixarChapOpen(3H) 

- read/write Chap Sbus device.libpixarChapSbus(3H) 

-setupaDumi device for diagnostic use.. libpixar:DumiOpen(3H) 

- setup a memory controller device for diagnostic use.libpixar.MctrlOpen(3H) 

- setup a disk buffer device for use..libpixarDbOpen(3H) 

- Pixar Chap graphics device interface. .chap(4) 

- Pixar Dumi device interface.dumi(4) 

- Pixar memory controller device interface. .mctrl(4) 

- Pixar video controller device interface. .video(4) 

- read/write Chap Mbus devices. libpixarChapMbus(3H) 

-Pixarsystem diagnostccheck.Diagnostic(8) 

- manipulate Chap diagnostic instruction register. .libpixanChapInst(3H) 

- setup a Dumi device for diagnostic use.libpixarDumiOpen(3H) 

- setup a memory controller device for diagnostic use. ..libpixar:MctrlOpen(3H) 

- transpose a pixel window around the diagonal axis.libpiri:PirlTranspose(3H) 

- transpose a pixel window around the diagonal axis.libpt:PWTranspose(3C) 

- PirlCopy with user-specified axes, start and direction parameters.libpirl:PirlCopy(3H) 

- PWCopy with user-specified axes, start and direction parameters.libpt:PWCopy(3C) 

-Chap disassembler. .chd(l) 

-sequential decoding of tile from disk. . . ...libpicio:PicDecode(3H) 

- sequential encoding of a tile to disk.libpicio:PicEncode(3H) 

-setup a disk buffer device for use. . ..libpixanDbOpen(3H) 

: Get/save a pixel from/to a disk file.libpiri:PirlGetPic(3H) 

- Display a pixel window on the monitor..libpiri:PirlDisplay(3H) 

formats. - display an image from raster files of various ........ see(l) 

- display Chap symbol table.chmap(l) 

- display color bars. .libpiri:PirlCbars(3H) 

- display fieldguide in framebuffer. .guide(l) 

- get/set video controller display format. .... libpixanVideoFormat(3H) 

- set video controller display state...libpixanVideoDisplay(3H) 

- add, subtract, multiply and divide scratchpad arrays.libpip:PWArithmetic(3C) 

- add, subtract, multiply and divide scratchpad arrays.libpip:SSArithmetic(3C) 

- divide two pixel windows.libpiri:PiriArithmetic(3H) 

4-way reciprocal square root of unsigned 32-bit double-precision fraction. - compute approximate .libpm:recsqrt(3Q 

- multiply a double-precision vector list by a double-precision matrix.iibpm:matrix(3C) 

matrix, -multiply a double-precision vector list by a double-precision.libpm:matrix(3Q 

- average 2 scanlines down to one of half size.... . libpx:SSHalve(3C) 

- download a Chap object file and staff it running. .chload(l) 

- compare a Chap object file to the downloaded version. ... . chcmp(l) 

- draw a ramp into a pixel window.libpirl:PirlRamp(3H) 

characteristics. - Draw lines in a pixel window and set line ..libpiri:PiriLine(3H) 

-setup a Dumi device for diagnostic use.IibpixanDumiOpen(3H) 

- Pixar Dumi device interface. ....dumi(4) 

- examine and modify Dumi registers. .dumi(l) 

-begin/end a dynamic load or unload..libpixar:ChapLoad(3H) 
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Permuted Index 


-fill 

- call a spad-to-spad routine for 

- shuffle components of 

- shuffle components of 

- Chap link 
- Chap assembler and link 

- picture 

- sequential 
- Pixar runtime environment 

- Pixar runtime 
a descriptive error message explaining the last 
- describe an 
- print a descriptive 


- print a descriptive error message 

- compute new pixel * 

- clear pixel window to 

- clear pixel window to 

- display 
: PIXAR special 

- get list of archive 

- display an image from raster 

- convolve a framebuffer image with a 3x3 

- convolve pixel window with 3x3 
- convolve pixel window with 3x3 separable 

-set up 
— applies a box 
pixel window. - 
window. - 
array. - 
- composite a 

- map a single component through a color table to 

- map a single component through a color table to 

- get/set video controller display 
- display an image from raster files of various 

- scale pixels using the 

- computes 2'32/n of 
square root of unsigned 32-bit double-precision 

- clear partial vertical scanline in 

- permutations of the 
vertical scanline from scratchpad integer array to 
/partial scanline from scratchpad integer array to 

-get a 

- copy component from scratchpad to 
value, -clear 
-save 

- copy a single tile between locations in 
PicGetFrame, PicPutFrame - get/put pictures from 
- copy partial vertical scanline backwards from 

- merge two 

- applies a box filter to the 
- copy utility for portions of the 

- compute a Cyclic Redundency Check (CRQ on a 

- display fieldguide in 

- resize utility for portions of the 

- perform linear arithmetic on 

- perform linear arithmetic on 

- routines for defining and getting 

- convolve a 

- rotate a 
-scale 

- reset Chap and 
- clamp the contents of a 

-ramp 

- accumulate 
: Get/save a pixel 

- Get/put a block of pixels 

- Mapping 


dynamically load and start up a file in the Chap, 
each Chap scratchpad memory with its address. 

each line of a pixel window. 

each pixel for a pixel window.. .. 

each pixel for a pixel window. 


fieldguide in framebuffer. . 

filename determination routines. 

files. 

files of various formats. 

fill each Chap scratchpad memory with its address. 


filter coefficients for subsequent hdl or vdl. 

filter to the framebuffer.. 

find the minimum and maximum pixel values in a . . 
find the minimum and maximum values in a pixel . . 
find the minimum and maximum values in a scratchpad 

foreground with a background.. . 

form a color image. 

form a color image. .............. 

format... 


formula A*x+B.. 

four non-negative 32-bit numbers. 

fraction. - compute approximate 4-way reciprocal 

frame buffer. . 

frame buffer. 

frame buffer IFxCopyBackwards /- copy partial 
frame buffer IFyCopy - copy partial vertical/ 
frame buffer image from a picture file. .... 

frame buffer in increasing y order. 

frame buffer in increasing y order to a component 

frame buffer into picture file. 

frame buffer memory. 

frame buffer to picture file. 

frame buffer to scratchpad.. 

frame buffer windows onto a third. 

framebuffer... 


framebuffer clear. . 

framebuffer definitions.. . 

framebuffer description definitions. . . . 
framebuffer image with a 3x3 filter. . . . 

framebuffer region.. 

framebuffer RGB A intensities. 

framebuffer state. 

framebuffer to [0..2048]. 

framebuffer tool.. 

framebuffer window horizontally or vertically, 
frequency histogram of a pixel window. . . 

from/to a disk file. 

from/to a pixel window.. . 

function for PirlMakeMap. . .. 


editor. .. 

editor output. . 

enable/disable memory management. 

encoding library. 

encoding of a tile to disk. 

entry/exit. .. 

environment entry/exit. . 

error, - print .. 

error by Chad. 

error message explaining the last error, 
examine and modify Dumi registers, 
execute routines on a Chap. . . . 

explaining the last error.. 

0 *pixel+b for a pixel window.. . . 

color . 

color ... 


filter. 

filter. 

filter. 


formats. 


framebuffer.. 

framebuffer... 

framebuffer.. 

framebuffer.. 

framebuffer animation tool, 
framebuffer channels. . . 
framebuffer channels. . . 


libpixar:ChapLoadGo(3H) 

libpixar: ChapS pad(3H) 

libpt:PWGeneric(3C) 

libpirl:PirlShuffle(3H) 

libpt:PWShuffle(3C) 

chld(l) 

chap.out(5) 

libpixar:ChapMMan(3H) 

libpicio:libpicio(3H) 

libpicio:PicEncode(3H) 

libpirl:PirlBegin(3H) 

libpirl:PirlBegin(3H) 

libpirl:PirlErrReport(3H) 

libchad:ChadErrReport(3H) 

libpirl: PirlErrReport(3 H) 

dumi(l) 

libchad:ChadGo(3H) 

libpirl:PirlErrReport(3H) 

libpt:PWAxb(3C) 

libpirl:PirlClear(3H) 

libpt:PWClear(3C) 

guide(l) 

libchad:getdevs(3 H) 

libpixar:ChapArchive(3H) 

see(l) 

libpixanChapSpad(3H) 

conv(l) 

libpip:PWc33(3Q 

libpip:PWc33s(3C) 

libpx:SSScaie(3C) 

blur(l) 

libpirl:PirlRange(3H) 

libpip:PWRange(3C) 

libpip:SSRange(3C) 

libpirl:PirlMerge(3H) 

libpip:PWMap(3C) 

libpirl:PirlMapComp(3H) 

libpixanVideoFormat(3H) 

see(l) 

libpt:SSAxb(3Q 

libpm:reciprocal(3C) 

libpm:recsqrt(3C) 

libpt:SFCopy(3C) 

perm(l) 

libpt:IFCopy(3Q 

libpt:IFCopy(3C) 

gt(l) 

libpt:RGBAFCopy(3C) 

libpt:CFCopy(3C) 

sv(l) 

libpt:TBCopy(3C) 

libpicio:PicFrame(3H) 

libpt:FSCopy(3C) 

merge(l) 

blur(l) 

copy(l) 

crc(l) 

guide(l) 

resizef 1) 

loop(l) 

cha(l) 

libpirl:PirlCha(3H) 

clr(l) 

libg:fbgetdef(3H) 
fbdefs(7) 
conv(l) 
rotate(l) 
scale(l) 

libpixanChapReset(3H) 

clamp( 1) 

tool(l) 

rampfl) 

libpirl:PiriHistogram!3H) 

libpirl:PirlGetPic(3H) 

Hbpirl:PirlGetBuf(3H) 

libpiri:PirlMakeMap!3H) 
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Permuted Index 


- introduction to Chap library 

- introduction to Pixar library 
- introduction to Host-resident Pixar library 

-set 

- introduction to Pixar library of 
- video coloibar 


PicGetFrame, PicPutFrame- 


- routines for defining and 

- Pixar Chap 
- average 2 scanlines down to one of 

- set/reset Chap interrupt 
- set up filter coefficients for subsequent 

- Take the 
- compute the 
- accumulate frequency 

- accumulate 

- ramp framebuffer window 

- introduction to 
integer array to frame buffer IFyCopy - copy/ 

from scratchpad integer array to frame buffer 
/from scratchpad integer array to frame buffer 
determine the smallest rectangle that surrounds an 
component through a color table to form a color 
determine the smallest rectangle that surrounds an 
component through a color table to form a color 

- get a raster 
- get a frame buffer 

- display an 

- access to Pixar 

- introduction to the Pixar 

- introduction to Pixar 

- convolve a framebuffer 

- Combine two 

copy component from scratchpad to frame buffer in 

- clear frame buffer in 
- type out picture file 

- get/set Chap configuration 


- accumulate histogram of 
- read/write multiple locations in Chap 

- manipulate Chap diagnostic 

- scale framebuffer RGB A 

- Pixar Chap graphics device 

- Pixar Dumi device 
- Pixar memory controller device 
- Pixar video controller device 
- set/reset Chap 


functions. - 


Chap routines.. - 


—tile to buffer 
- convolve scratchpad buffers with 3x3 

- convolve scratchpad buffers with 3x3 separable 

- convolve scratchpad buffers with 5x5 separable 

- convolve pixel window with a 1-d 

- convolve scratchpad buffer with 1-d 

- convolve a pixel window with a 1-d 

- convolve pixel window with a 3x3 

- handle picture 


functions. 

functions.. . 

functions. 

FYCopy. .. 

gamma-corrected colormap. 

general-purpose Chap routines. 

generator..... 

Get/put a block of pixels from/to a pixel window. . 
get/put a buffer into a pixel window. ...... 

get/put pictures from frame buffer to picture file. 

Get/save a pixel from/to a disk file. 

get/set Chap configuration information. 

get/set the video controller color map. 

get/set video controller display format. 

getting framebuffer definitions. 

graphics device interface. 

half size. 

handle picture labels. 

handling. 

hdlorvdl.. 

histogram of a picture. 

histogram of a pixel window. 

histogram of a pixel window. .. 

histogram of input component array. 

horizontally or vertically. 

Host-resident Pixar library functions. 

IFxCopy: copy partial scanline from scratchpad 
IFxCopyBackwards /- copy partial vertical scanline 
IFyCopy - copy partial vertical scanline from/ . . 

image. -. 

image, -mapa single . ... . 

image. -... . . . . 

image, - map a single . 

image file into a pixel window. 

image from a picture file. 

image from raster files of various formats. . . . . 

image memory. 

image processing library. 

image transformation library. 

image with a 3x3 filter. . 

images. . 

increasing y order. - . 

increasing y order to a component value. 

information. . . . .. 

information... 

initialize quadratic warping table.. . 

initialize the pixar and the configuration tables. . . 

input component array. . .. 

instruction memory. 

instruction register.. 

intensities. . . .... 

interface. .. 

interface. 

interface. 

interface. . . ... . . . 

interrupt handling. 

introduction to Chap library functions. 

introduction to Chap Pixel Transfer Library. . . . 
introduction to Host-resident Pixar library . . . . 

introduction to Pixar arithmetic library. 

introduction to Pixar color-transformation library. . 
introduction to Pixar image transformation library. 

introduction to Pixar library functions. 

introduction to Pixar library of general-purpose . . 

Introduction to Pixar Resource Library. 

introduction to shell-level Pixar utilities. 

introduction to the Pixar image processing library. 

I/O... 

kernel. 

kernel... 

kernel.... . . 

kernel. 

kernel.. 

kernel.. 

kernel... 

labels. .. 


intro(3Q 

intro(3H) 

libpixar:libpixar(3H) 

libpt:FYCopy(3Q 

gamma(l) 

libpg:libpg(3Q 

cbars(l) 

libpirl:PirlGetBuf(3H) 

libpirl:PirlFrame(3H) 

libpicio:PicFrame(3H) 

libpirl:PirlGetPic(3H) 

libpixar:ChapConfig(3H) 

libpixanVideoCmap(3H) 

libpixar:VideoFormat(3H) 

libg:fbgetdef(3H) 

chap(4) 

libpx:SSHalve(3C) 

libpicio:PicLabel(3H) 

libpixar:ChapWait(3H) 

libpx:SSScale(3C) 

hg(l) 

libpip:PWHistogram(3C) 

libpiri:PirlHistogram(3H) 

libpip:dhg(3C) 

ramp(l) 

libpixarlibpixar(3H) 

libpt:IFCopy(3Q 

libpt:IFCopy(3C) 

libpt:IFCopy(3Q 

libpip:PWBBox(3C) 

libpip:PWMap(3C) 

libpirl:PirlBBox(3H) 

libpirl:PirlMapComp(3H) 

libpirl:PirlGetRaster(3H) 

gt(l) 

libchad:ChadFrame(3H) 

libpip:libpip(3C) 

libpx:libpx(3C) 

conv(l) 

libpt:SSComb(3Q 

libpt:RGBAFCopy(3Q 

libpt:CFCopy(3C) 

gtinfo(l) 

libpixanChapConfig(3H) 

libpx:stwarptable(3C) 

pixinit(l) 

libpip:dhg(3C) 

libpixarChapRam(3H) 

IibpixanChapInst(3H) 

scale(l) 

chap(4) 

dumi(4) 

mctrl(4) 

video(4) 

libpixar:ChapWait(3H) 

intro(3C) 

libpt:libpt(3C) 

libpixar.libpixar(3H) 

libpm:libpm(3Q 

iibcolorlibcolor(3C) 

libpx:libpx(3Q 

intro(3H) 

libpg:libpg(3C) 

libpirl:libpirl(3H) 

intro(l) 

libpip:libpip(3Q 

libpicio:PicRead(3H) 

libpip:C33(3C) 

libpip:C33s(3C) 

libpip:C55s(3C) 

libpip:PWConv(3Q 

libpip:SSConv(3Q 

libpirl:PiriConvolve(3H) 

libpirl:PirlConvolve3x3(3H) 

libpicio:PicLabel(3H) 
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Permuted Index 


- convert archives to Chap random 

- Pixar resource-management 

- Pixar resource-management 

- introduction to Pixar color-transformation 

- picture encoding 

- introduction to the Pixar image processing 

- Introduction to Pixar Resource 

- introduction to Pixar arithmetic 

- introduction to Chap Pixel Transfer 

- introduction to Pixar image transformation 

- introduction to Chap 

- introduction to Pixar 

- introduction to Host-resident Pixar 

- introduction to Pixar 
- Draw lines in a pixel window and set 

- call a spad-to-spad routine for each 

-perform 
-perform 
characteristics. - Draw 
-Chap 

- Chap assembler and 

- multiply a double-precision vector 

- print name 
-get 
- dynamically 

- begin/end a dynamic 

- set the 
- read/write multiple 
- copy a single tile between 

— enable/disable memory 

- memory 

- memory 


-4-way 

- 4-way mapping of scratchpad values using a 
- set a pixel window’s channel 
- set a pixel window channel 
double-precision vector list by a double-precision 
- merge pixels using spad 

- find die minimum and 

- find the minimum and 

- find the minimum and 

- read/write Chap 

- access to Pixar image 
read/write multiple locations in Chap instruction 

a single tile between locations in frame buffer 

- set/clear options of a 

- setup a 
-Pixar 
- enable/disable 


- fill each Chap scratchpad 


- scratchpad to scratchpad 

- print a descriptive error 

- find the 

- find the 

- find the 

- examine and 
— Chap runtime 

- Display a pixel window on the 
- Zoom in on a pixel window on the 
-read/write 
double-precision matrix. - 

- add, subtract, 

- add, subtract, 

- print 

window., -compute 
- compute 

- Make a 

- computes 2*32/n of four 


libraries. 

library. 

library... 

library. 

library. 

library. 

Library... 

library.. 

Library. .. 

library.. 

library functions. 

library functions. . .. 

library functions. 

library of general-purpose Chap routines. 

line characteristics. 

line of a pixel window. 

linear arithmetic on framebuffer channels. 

linear arithmetic on framebuffer channels. 

lines in a pixel window and set line . 

link editor. . 

link editor output. 

list by a double-precision matrix. 

list of a Chap object file. 

list of archive files... 

load and start up a file in the Chap. 

load or unload. . .. 

location of a video controller cursor. 

locations in Chap instruction memory. 

locations in frame buffer memory. 

Make a new pixel window under Pirl. 

management. . 

management support. 

management support . 

manipulate Chap diagnostic instruction register. . . 
Mapping function for PiriMakeMap. ....... 

mapping of scratchpad values using a mapping table. 

mapping table. 

mask. . 

mask. .. 

matrix, - multiply a . 

matte. 

maximum pixel values in a pixel window. 

maximum values in a pixel window. 

maximum values in a scratchpad array. 

Mbus devices. 

memory. 

memory. -. 

memory. - copy. 

memory controller.. 

memory controller device for diagnostic use. 

memory controller device interface. 

memory management. 

memory management support .. 

memory management support . 

memory with its address. 

merge pixels using spad matte. 

merge two frame buffer windows onto a third. . . . 

merge two pixel windows into a third. 

merge using UNDER operator. . 

message explaining the last error. .. 

minimum and maximum pixel values in a pixel window, 
minimum and maximum values in a pixel window, 
minimum and maximum values in a scratchpad array. 

modify Dumi registers. 

monitor. . . ... 

monitor. 

monitor. . 

multiple locations in Chap instruction memory. . . . 
multiply a double-precision vector list by a . . . . 

multiply and divide scratchpad arrays. 

multiply and divide scratchpad airays. 

name list of a Chap object file. 

new pixel » a*pixel+b for a pixel . 

new pixel * pixel-b fora pixel window. 

new pixel window under Pirl. 

non-negative 32-bit numbers. 


chranlib(l) 

libchad:ChadBegin(3H) 

libchad :1 ibchad(3H) 

libcolor:libcolor(3C) 

libpicio:libpicio(3H) 

libpip:libpip(3Q 

libpirl:libpirl(3H) 

libpm:libpm(3C) 

libpt:libpt(3C) 

libpx:libpx(3C) 

intro(3C) 

intro(3H) 

libpixar:libpixar(3H) 

libpg:libpg(3C) 

libpirl:PirlLine(3H) 

libpt:PWGeneric(3C) 

cha(l) 

libpirl:PirlCha(3H) 

libpirl: Pi rlLi ne(3 H) 

chld(l) 

chap.out(5) 

libpm:matrix(3C) 

chnm(l) 

libpixar:ChapArchive(3H) 

Hbpixar:ChapLoadGo(3H) 

libpixar:ChapLoad(3H) 

libpixar: V ideoCursor(3H) 

libpixar:ChapRam(3H) 

libpt:TBCopy(3C) 

libpirl:PirlNewPW(3H) 

libpixar:ChapMMan(3H) 

libpg:mman(3Q 

zzsave:mman(3C) 

libpixar:ChapInst(3H) 

libpirl:PirlMakeMap(3H) 

libpt:SS4Map(3Q 

libpt:SS4Map(3C) 

libpirl:PirlSetChannelMask(3I I) 

libpt:PW(3C) 

libpm:matrix(3C) 

libpt:SSPaint(3C) 

libpirl:PirlRange(3H) 

libpip:PWRange(3Q 

libpip:SSRange(3Q 

libpixar:ChapMbus(3H) 

libchad:ChadFrame(3H) 

libpixar:ChapRam(3H) 

libpt:TBCopy(3Q 

mctri(8) 

libpixanMctrlOpen(3H) 

mctrl(4) 

libpixanChapMMan(3 H) 

libpg:mman(3Q 

zzsave:mman(3C) 

libpixanChapSpad(3H) 

libpt:SSPaint(3C) 

merge(l) 

libpt:PWMerge(3C) 

libpt:SSMerge(3C) 

libpirl:PirlErrReport(3H) 

libpiri:PirlRange(3H) 

libpip:PWRange(3C) 

libpip:SSRange(3Q 

dumi(l) 

charm(l) 

libpirl: Pi rl Di splay (3H) 

libpirl:Pir!Zoom(3H) 

libpixar:ChapRam(3H) 

libpm:matrix(3C) 

libpip:PWArithmetic(3C) 

libpip:SSArithmetic(3C) 

chnm(l) 

libpt:PWAxb(3C) 

libpirl:PiriAxb(3H) 

libpirl:PirlNewPW(3H) 

libpm:reciprocal(3C) 


Pixar 


-XXXV 


July 1986 












































































Permuted Index 


- computes 2 A 32/n of four non-negative 32-bit 

- produce 4 random 
- print name list of a Chap 

- size of a Chap 

- download a Chap 
- compare a Chap 

SSRtoRGBA, SSGtoRGBA, SSBtoRGBA, SSAtoRGBA: Copy 
/SSGtoRGBALUT, SSBtoRGBALUT, SSAtoRGBALUT: Copy 

SSRRRRtoRRRR,Copy 
- average 2 scanlines down to 
-copy 

- merge two frame buffer windows 


- scratchpad to scratchpad merge using UNDER 

- set/clear 

from scratchpad to frame buffer in increasing y 
- clear frame buffer in increasing y 
- Chap assembler and link editor 
with user-specified axes, start and direction 
with user-specified axes, start and direction 
frame buffer IFyCopy - copy/ IFxCopy: copy 

-copy 

-copy 

buffer to scratchpad, - copy 
/integer array to frame buffer IFyCopy - copy 

- clear 
window. - 
window. - 


window. - 
window. - 
scanline in scratchpad. — 

frame buffer to picture file, 
picture file. PicGetFrame, 
- Take the histogram of a 

- get a frame buffer image from a 
- close a 

- create/open a 

PicPutFrame - get/put pictures from frame buffer to 

- save frame buffer into 

- type out 
-handle 

PicGetFrame, PicPutFrame - get/put 
- Make a new pixel window under 
direction parameters. - 

- Mapping function for 

- initialize the 

- introduction to 

- introduction to 

- access to 
- introduction to the 

- introduction to 

- introduction to 
- introduction to Host-resident 

- introduction to 

- Introduction to 


- introduction to shell-level 

- compute new 

- compute new 
- copy mnlength array to scratchpad 

window, -clamp 
window, - clamp 
- compare scanline 


numbers.libpm:reciprocal(3C) 

numbers.libpm:rrand(3C) 

object file..chnm(l) 

object file... chsize(l) 

object file and start it running.chloadf 1) 

object file to the downloaded version.chcmp(l) 

one channel from scratchpad to 4 channels.libpt:SSCopyRGBA(3C) 

one channel from scratchpad to 4 channels through a 1 .... libpt:SSCopyRGBALUT(3C) 

one channel from scratchpad to another channel.libpt:SSCopyComp(3C) 

one of half size..libpx:SSHalve(3C) 

one scanline repeatedly into a pixel window.. libpirl:PirlSweep(3H) 

onto a third...merge(l) 

open/close a Chap device.libpixar:ChapOpen(3H) 

open/close a video controller....5ibpixanVideoOpen(3H) 

operator. ..libpt:SSMerge(3C) 

options of a memory controller..mctrl(8) 

order. - copy component .libpt:RGBAFCopy(3C) 

order to a component value.libpt:CFCopy(3C) 

output.,.chap.out(S) 

parameters. -PirlCopy .libpirl:PirlCopy(3H) 

parameters. -PWCopy .. libpt:PWCopy(3C) 

partial scanline from scratchpad integer array to .libpt:IFCopy(3C) 

partial scanline from scratchpad to scratchpad. .libpt:SCCopy(3C) 

partial scanline from scratchpad to scratchpad.libpt:SSCopy(3C) 

partial vertical scanline backwards from frame.libpt:FSCopy(3C) 

partial vertical scanline from scratchpad integer/ .libpt:IFCopy(3C) 

partial vertical scanline in frame buffer..libpt:SFCopy(3C) 

perform channel arithmetic on the pixels of a pixel .libpt:PWCha(3C) 

perform channel arithmetic on the pixels of a pixel .libpt:SSCha(3Q 

perform linear arithmetic on framebuffer channels.cha( 1) 

perform linear arithmetic on framebuffer channels.libpirl:PirlCha(3H) 

performs a Cyclic Redundency Check (CRQ on a pixel . . . libpip:PWCrc(3C) 

performs a Cyclic Redundency Check (CRC) on a pixel . . . libpirl:PirlCrc(3H) 

performs a Cyclic Redundency Check (CRC) on a .libpip:SSCrc(3C) 

permutations of the frame buffer..perm( 1) 

PicGetFrame, PicPutFrame - get/put pictures from .libpicio:PicFrame(3H) 

PicPutFrame - get/put pictures from frame buffer to.libpicio:PicFrame(3H) 

picture.hg(l) 

picture encoding library.libpicio:libpicio(3H) 

picture file.gt(l) 

picture file..libpicio:PicClose(3H) 

picture file. .libpicio:PicCreat(3H) 

picture file. PicGetFrame, .libpicio:PicFrame(3H) 

picture file.sv(l) 

picture file information.gtinfo(l) 

picture labels.libpicio:PicLabel(3H) 

pictures from frame buffer to picture file.libpicio:PicFrame(3H) 

Pirl.libpirl:PirlNewPW(3H) 

PirlCopy with user-specified axes, start and .libpirl:PirlCopy(3H) 

PirlMakeMap.libpirl:PirlMakeMap(3H) 

pixar and the configuration tables. .pixinit(l) 

Pixar arithmetic library.libpm:libpm(3C) 

Pixar Chap graphics device interface.chap(4) 

Pixar color-transformation library.libcolonlibcolor(3C) 

Pixar Dumi device interface.dumi(4) 

Pixar image memory..libchad:ChadFrame(3H) 

Pixar image processing library. libpip:libpip(3Q 

Pixar image transformation library.libpx:libpx(3Q 

Pixar library functions.intro(3H) 

Pixar library fimctions. . . . libpixanlibpixar(3H) 

Pixar library of general-purpose Chap routines.libpg:libpg(3Q 

Pixar memory controller device interface.mctrl(4) 

Pixar Resource Library.. libpirl:libpirl(3H) 

Pixar resource-management library.libchad:ChadBegin(3H) 

Pixar resource-management library. .libchad:libchad(3H) 

Pixar runtime environment entry/exit. .libpirl:PirlBegin(3H) 

PIXAR special filename determination routines.libchad:getdevs(3H) 

Pixar system diagnostc check. .Diagnostic(8) 

Pixar utilities... . intro(l) 

Pixar video controller device interface.video(4) 

pixel » a*pixei+& for a pixel window..libpt:PWAxb(3Q 

pixel * pixel-b for a pixel window..libpirl:PirlAxb(3H) 

pixel array. .libpt:RSCopy(3C) 

pixel between 0.0 (0) and 1.0 (0x800) for a pixel .libpiri:PiriClamp(3H) 

pixel between 0.0 (0) and 1.0 (0x800) for a pixel .libpt:PWCIamp(3Q 

pixel buffers in scratchpad.libpt:SSCompare(3C) 
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Permuted Index 


- shuffle components of each pixel for a pixel window.. . . 

- shuffle components of each pixel for a pixel window. 

: Get/save a pixel from/to a disk file. 

- introduction to Chap Pixel Transfer Library. 

- subtract pixel value from 1.0 (0x800) for a pixel window. 

- subtract pixel value from 1.0 (0x800) for a pixel window. 

- find the minimum and maximum pixel values in a pixel window. 

- clamp pixel values to the range [0,1.0E]. 

- performs a Cyclic Redundency Check (CRQ on a pixel window. 

- compute the histogram of a pixel window.. 

- find the minimum and maximum values in a pixel window. 

- compute new pixel = pixel-6 for a pixel window. 

clamp pixel between 0.0(0) and 1.0 (0x800) for a pixel window. -. 

- performs a Cyclic Redundency Check (CRC) on a pixel window. 

- get/put a buffer into a pixel window. 

- Get/put a block of pixels from/to a pixel window. 

- get a raster image file into a pixel window. 

- accumulate frequency histogram of a pixel window. 

- remap 4 components of a pixel window. 

- subtract pixel value from 1.0 (0x800) for a pixel window. 

- draw a ramp into a pixel window.. 

- find the minimum and maximum pixel values in a pixel window.. . 

- copy the source pixel window to the destination pixel window.. 

- rotate a pixel window. 

- Shear a pixel window. 

- shuffle components of each pixel for a pixel window. 

- swap the source pixel window and the destination pixel window.. 

- copy one scanline repeatedly into a pixel window. 

- remap 4 components of a pixel window. 

- compute new pixel = <a*pixel+6 for a pixel window. 

— perform channel arithmetic on the pixels of a pixel window. 

clamp pixel between 0.0 (0) and 1.0 (0x800) for a pixel window. —. 

- call a spad-to-spad routine for each line of a pixel window. 

— subtract pixel value from 1.0 (0x800) for a pixel window. 

- shuffle components of each pixel for a pixel window.. 

- swap the source pixel window and the destination pixel window. 

- perform channel arithmetic on the pixels of a pixel window.. 

- resize source pixel window to destination pixel window. 

-Sheara pixel window. 

- Draw lines in a pixel window and set line characteristics. . . 

- swap the source pixel window and the destination pixel window. 

- swap the source pixel window and the destination pixel window.. 

-reflect the pixel window around its center vertical axis. . . 

- transpose a pixel window around the diagonal axis. 

- transpose a pixel window around the diagonal axis. 

-convolve pixel window buffer with 1-d pulse (box). . . . 
-convolve pixel window buffer with 1-d pulse (box). . . . 

- set a pixel window channel mask. .. . . 

- circular shift pixel window contents in x and/or y. 

- circular shift pixel window contents in x and/or y. 

- Display a pixel window on the monitor.. 

- Zoom in on a pixel window on the monitor. 

- resize source pixel window to destination pixel window. . . 

- clear pixel window to color . 

- clear pixel window to color. . 

- copy the source pixel window to the destination pixel window. 

— Make a new pixel window under Pirl. 

- convolve pixel window with 3x3 filter. . 

-convolve pixel window with 3x3 separable filter. . . . . 

- convolve pixel window with a 1-d kernel. 

- convolve a pixel window with a 1-d kernel. 

- convolve pixel window with a 3x3 kernel. 

- divide two pixel windows. 

- set a pixel window’s channel mask. . 

- merge two pixel windows into a third. 

- compute new pixel = pixel-6 for a pixel window. 

- Get/put a block of pixels from/to a pixel window. 

- perform channel arithmetic on the pixels of a pixel window. . 

- perform channel arithmetic on the pixels of a pixel window. 

- merge pixels using spad matte. 

- scale pixels using the formula A*x+B. 

- copy utility for portions of the framebuffer. . 

- resize utility for portions of the framebuffer. . 

last error. - print a descriptive error message explaining the . 
- print name list of a Chap object file. 

— introduction to the Pixar image processing library. 


libpirl:PirlShuffle(3H) 

libpt:PWShuffle(3C) 

libpirl:PirlGetPic(3H) 

Iibpt:libpt(3C) 

libpirl:PirlNot(3H) 

libpt:PWNot(3C) 

libpirl:PirlRange(3H) 

libcolor:SSClamp(3C) 

libpip:PWCrc(3C) 

libpip:PWHistogram(3C) 

libpip:PWRange(3C) 

Iibpirl:PirlAxb(3H) 

libpiri: PirlClamp(3H) 

libpirl:PirlCrc(3H) 

libpirl:PirlFrame(3H) 

libpirl:PirlGetBuf(3H) 

libpirl:PirlGetRaster(3H) 

libpirl:PirlHistogram(3H) 

libpirl:PirlMap(3H) 

libpirl:PirlNot(3H) 

libpirl:PirlRamp(3H) 

libpirl:PirlRange(3H) 

libpirl:PirlResize(3H) 

libpirl:PirlRotate(3H) 

libpirl:PirlShear(3H) 

libpiri: Pi rlShuffle(3H) 

libpiri: PirlSwap(3H) 

libpirl:PirlSweep(3H) 

libpt:PW4Map(3Q 

libpt:PWAxb(3C) 

libpt:PWCha(3Q 

libpt:PWClamp(3C) 

libpt:PWGeneric(3C) 

libpt:PWNot(3C) 

libpt:PWShuffle(3C) 

libpt:PWSwap(3Q 

libpt:SSCha(3C) 

libpx:PWResize(3C) 

libpx :PW Shear(3C) 

libpirl:PirlLine(3H) 

libpiri:PirlSwap(3H) 

libpt:PWSwap(3C) 

libpirl:PirlReflect(3H) 

libpirl:PirlTranspose(3H) 

libptrPWT ranspose(3C) 

libpip:PWBoxFilter(3C) 

libpirl:PirlBoxFilter(3H) 

libpt:PW(3C) 

libpiri: PirlShift(3H) 

libpt:PWShift(3C) 

libpirl:PirlDisplay(3H) 

libpiri: PirlZoom(3H) 

libpx :PWResize(3C) 

libpirl:PirlClear(3H) 

libpt:PWClear(3C) 

libpiri:PirlResize(3H) 

libpirl:PirlNewPW(3H) 

libpip:PWc33(3Q 

libpip:PWc33s(3Q 

libpip:PWConv(3Q 

!ibpiri:PirlConvolve(3H) 

libpirl:PirlConvolve3x3(3H) 

libpirl:PirlArithmetic(3H) 

libpirl:PirlSetChannelMask(3H) 

libpt:PWMerge(3C) 

libpirl:PirlAxb(3H) 

libpiri:PirlGetBuf(3H) 

libpt:PWCha(3C) 

libpt:SSCha(3Q 

libpt:SSPaint(3C) 

libpt:SSAxb(3Q 

copy(l) 

resize(l) 

libpirl:PirlErrReport(3H) 

chnm(l) 

libpip:libpip(3Q 
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Permuted Index 


- produce 4 random numbers..libpm:rrand(3Q 

- convolve pixel window buffer with 1-d pulse (box).Iibpip:PWBoxFilter(3C) 

- convolve scratchpad buffer with 1-d pulse (box).libpip:SSBoxFilter(3C) 

- convolve pixel window buffer with 1-d pulse (box).libpirl:PirlBoxFilter(3H) 

direction parameters. - PWCopy with user-specified axes, start and .libpt:PWCopy(3C) 

- register quad_pixel-> quad_pixel.libpm:xp(3C) 

- register quad__pixel -> quad_pixel..libpm:xp(3Q 

-initialize quadratic warping table..libpx:stwarptable(3C) 

- ramp framebuffer window horizontally or vertically.ramp(l) 

- draw a ramp into a pixel window. .libpirl:PirlRamp(3H) 

- convert archives to Chap random libraries.chranlib(l) 

-produced random numbers.libpm:rrand(3C) 

- clamp pixel values to the range [0,1.0E].libcolor:SSClamp(3C) 

- display an image from raster files of various formats.see(l) 

- get a raster image file into a pixel window.libpirl:PirlGetRaster(3H) 

- read a Chap Abus device. . . ..libpixar:ChapAbus(3H) 

- read/write Chap crossbar state.libpixar:ChapXbar(3H) 

- read/write Chap Mbus devices.libpixanChapMbus(3H) 

- read/write Chap runflag state.libpixar:ChapStack(3H) 

- read/write Chap Sbus device.libpixar:ChapSbus(3H) 

memory. - read/write multiple locations in Chap instruction .libpixar:ChapRam(3H) 

double-precision/- compute approximate 4-way reciprocal square root of unsigned 32-bit .. libpm:recsqrt(3Q 

- determine the smallest rectangle that surrounds an image.libpip:PWBBox(3Q 

- determine the smallest rectangle that surrounds an image..libpirl:PirlBBox(3H) 

- convert unnormalized CIE coordinates to red-green-blue values.libcolonXYZ2rgb(3C) 

- convert red-green-blue values to CIE coordinates.Hbcolonrgb2xyY(3C) 

coordinates, - convert red-green-blue values to unnormalized CIE .libcolor:rgb2XYZ(3C) 

- compute a Cyclic Redundency Check (CRC) on a framebuffer..crc(l) 

- performs a Cyclic Redundency Check (CRC) on a pixel window.libpip:PWCrc(3C) 

- performs a Cyclic Redundency Check (CRC) on a pixel window.libpirl:PirlCrc(3H) 

- performs a Cyclic Redundency Check (CRC) on a scanline in scratchpad.libpip:SSCrc(3C) 

axis. - reflect the pixel window around its center vertical.libpirl:PirlReflect(3H) 

- rotate a framebuffer region.rotate( 1) 

-write a Chap alu register. .libpixar.ChapAlu(3H) 

- manipulate Chap diagnostic instruction register. .. libpixar:ChapInst(3H) 

- register quad_pixel -> quad_pixel.libpm:xp(3C) 

- Chap sysbus register routines.libpixar:ChapReg(3H) 

- examine and modify Dumi registers.dumi(l) 

- save and restore all volatile registers from scratchpad stack. .libpg:stack(3Q 

- remap 4 components of a pixel window. .. libpirl:PirlMap(3H) 

- remap 4 components of a pixel window.libpt:PW4Map(3Q 

- copy one scanline repeatedly into a pixel window.libpirl:PirlSweep(3H) 

- reset Chap and framebuffer state.libpixar:ChapReset(3H) 

window. - resize source pixel window to destination pixel.libpx:PWResize(3C) 

- resize utility for portions of the framebuffer..resize(l) 

-Chad resource allocation routines..'.libchad:ChadAlloc(3H) 

- Introduction to Pixar Resource Library.libpirl:libpirl(3H) 

- Pixar resource-management library.libchad:ChadBegin(3H) 

- Pixar resource-management library.libchad:libchad(3H) 

- write/read Chap resources.libchad:ChadWrite(3H) 

stack. - save and restore all volatile registers from scratchpad .libpg:stack(3Q 

- scale framebuffer RGB A intensities.scale(l) 

- compute approximate 4-way reciprocal square root of unsigned 32-bit double-precision fraction.libpm:recsqrt(3C) 

- compute approximate 4-way square root of unsigned 32-bit integer. .libpm:sqrt(3C) 

- rotate a framebuffer region.. rotate(l) 

- rotate a pixel window. ..libpirl:PirlRotate(3H) 

- SSCopy with specified channel rotation.libpt:SSShuffle(3Q 

- call a spad-to-spad routine for each line of a pixel window..libpt:PWGeneric(3Q 

- Chad resource allocation routines. .libchad:ChadAlloc(3H) 

: PIXAR special filename determination routines.... libchad:getdevs(3H) 

to Pixar library of general-purpose Chap routines., -introduction.libpg:libpg(3Q 

- Chap sysbus register routines.libpixar.ChapReg(3H) 

- Chap symbol table routines.... . libpixanChapSym(3H) 

definitions.. - routines for defining and getting framebuffer . . ..libg:fbgetdef(3H) 

- execute routines on a Chap.libchad:ChadGo(3H) 

- read/write Chap runflag state.. libpixanChapStack(3H) 

- copy scratchpad channel array to runlength array. ..libpt:CRCopy(3Q 

-copy runlength array to scratchpad pixel array.libpt:RSCopy(3C) 

- download a Chap object file and start it tunning.. chload(l) 

- Chap runtime control.UbpixanChapRun(3H) 

- Pixar runtime environment entry/exit.. libpirl:PirlBegin(3H) 

-Chap runtime monitor....charm(l) 

- Chap runtime symbol table. ..chapsym(5) 

scratchpad stack. - save and restore all volatile registers from . ..libpg:stack(3Q 

- save frame buffer into picture file. ..sv(l) 

- read/write Chap Sbus device...libpixanChapSbus(3H) 
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Permuted Index 


- scale framebuffer RGB A intensities. 

- scale pixels using the formula A*x+B. 

channel array. - copy vertical scanline backwards from alpha fb channel to spad . . . 

integer array. - copy vertical scanline backwards from alpha fb channel to spad . . . 

- copy partial vertical scanline backwards from frame buffer to scratchpad. . . 

array. - copy vertical scanline from arbitrary fb channel to spad channel . . . 

/to frame buffer IFyCopy - copy partial vertical scanline from scratchpad integer array to frame/ . . . 

buffer IFyCopy — copy/ IFxCopy: copy partial scanline from scratchpad integer array to frame .... 

- copy partial scanline from scratchpad to scratchpad. 

- copy partial scanline from scratchpad to scratchpad. . .. 

- clear partial vertical scanline in frame buffer.... 

- performs a Cyclic Redundency Check (CRC) on a scanline in scratchpad. 

- compare scanline pixel buffers in scratchpad. 

- copy one scanline repeatedly into a pixel window. 

-average 2 scanlines down to one of half size. .. 

a Cyclic Redundency Check (CRC) on a scanline in scratchpad. - performs . 

vertical scanline backwards from frame buffer to scratchpad, -copy partial ... 

- copy partial scanline from scratchpad to scratchpad... 

- compare scanline pixel buffers in scratchpad. 

- copy partial scanline from scratchpad to scratchpad. 

- find the minimum and maximum values in a scratchpad array. 

- add, subtract, multiply and divide scratchpad arrays. ... 

- add, subtract, multiply and divide scratchpad arrays. 

- convolve scratchpad buffer with 1-d kernel. 

- convolve scratchpad buffer with 1-d pulse (box). 

- convolve scratchpad buffers with 3x3 kernel. 

- convolve scratchpad buffers with 3x3 separable kernel. 

- convolve scratchpad buffers with 5x5 separable kernel. 

- copy scratchpad channel array to runlength array. 

- copy scratchpad integer array to scratchpad integer array.. 

IFyCopy — copy partial vertical scanline from scratchpad integer array to frame buffer/ /buffer . . . 

- copy/ IFxCopy: copy partial scanline from scratchpad integer array to frame buffer IFyCopy . . . 

array, -copy scratchpad integer array to scratchpad integer .... 

- fill each Chap scratchpad memory with its address. 

- scratchpad to scratchpad merge using UNDER operator.. 

- copy runlength array to scratchpad pixel array... 

- save and restore all volatile registers from scratchpad stack.. 

SSBtoRGB A, SSAtoRGB A: Copy one channel from scratchpad to 4 channels. SSRtoRGBA, SSGtoRGBA, 

/SSBtoRGBALUT, SSAtoRGBALUT: Copy one channel from scratchpad to 4 channels through a color table. 

SSRRRRtoRRRR,...: Copy one channel from scratchpad to another channel. 

- copy component from scratchpad to frame buffer in increasing y order. . . . 

- copy partial scanline from scratchpad to scratchpad. .. 

- copy partial scanline from scratchpad to scratchpad... 

operator. - scratchpad to scratchpad merge using UNDER .... 
- 4-way mapping of scratchpad values using a mapping table. .. 

- convolve pixel window with 3x3 separable filter. . 

- convolve scratchpad buffers with 3x3 separable kernel. 

- convolve scratchpad buffers with 5x5 separable kernel. 

- sequential decoding of tile from disk. 

- sequential encoding of a tile to disk. . 

- set a pixel window channel mask. 

- set a pixel window’s channel mask. . .. 

- set and clear Chap breakpoints. 

- set gamma-corrected colormap. 

— Draw lines in a pixel window and set line characteristics. . .. 

- set the location of a video controller cursor. . 

vdl. - set up filter coefficients for subsequent hdl or .... 

- set video controller display state.. 

- set/clear options of a memory controller. . 

- set/reset Qiap interrupt handling. 

- setup a disk buffer device for use. 

- setup a Dumi device for diagnostic use. 

use. - setup a memory controller device for diagnostic . . . 

- Shear a pixel window. 

- Shear a pixel window. . .. 

- introduction to shell-level Pixar utilities. .. 

- circular shift pixel window contents in x and/or y. 

- circular shift pixel window contents in x and/or y. 

window.. - shuffle components of each pixel for a pixel . 

window.. - shuffle components of each pixel for a pixel . 

- clear an integer array to a single channel value... 

color image, -map a single component through a color table to form a . . . 

color image, - map a single component through a color table to form a . . . 

memory. - copy a single tile between locations in frame buffer. 

- average 2 scanlines down to one of half size.... 

- size of a Chap object file. . 


scale(l) 

libpt:SSAxb(3C) 

libpt:FCCopy(3C) 

libpt:FICopy(3C) 

libpt:FSCopy(3C) 

libpt:FRGBACopy(3C) 

libpt:IFCopy(3C) 

libpt:IFCopy(3C) 

libpt:SCCopy(3C) 

libpt:SSCopy(3C) 

libpt:SFCopy(3C) 

libpip:SSCrc(3C) 

libpt:SSCompare(3C) 

libpirl:PirlSweep(3H) 

libpx:SSHa!ve(3C) 

libpip:SSCrc(3C) 

libpt:FSCopy(3C) 

Iibpt:SCCopy(3C) 

libpt:SSCompare(3C) 

libpt:SSCopy(3C) 

libpip:SSRange(3C) 

libpip:PWArithmetic(3C) 

libpip:SSArithmetic(3C) 

libpip:SSConv(3C) 

libpip:SSBoxFilter(3C) 

libpip:C33(3C) 

libpip:C33s(3C) 

libpip:C55s(3C) 

libpt:CRCopy(3C) 

libpt:CICopy(3Q 

libpt:IFCopy(3C) 

libpt:IFCopy(3C) 

libpt:CICopy(3C) 

libpixanChapSpad(3H) 

libpt:SSMerge(3C) 

libpt:RSCopy(3Q 

libpg:stack(3C) 

libpt:SSCopyRGBA(3C) 

libpt:SSCopyRGBALUT(3C) 

libpt:SSCopyComp(3C) 

Iibpt:RGBAFCopy(3C) 

libpt:SCCopy(3C) 

libpt:SSCopy(3C) 

libpt:SSMerge(3C) 

libpt:SS4Map(3C) 

libpip:PWc33s(3C) 

libpip:C33s(3C) 

libpip:C55s(3C) 

libpicio:PicDecode(3H) 

Ubpicio:PicEncode(3H) 

libpt:PW(3C) 

libpirl:PirlSetChanne!Mask(3H) 

libpixanChapB pt(3H) 

gamma(l) 

libpirl:PirlLine(3H) 

libpixanVideoCursor(3H) 

libpx:SSScale(3Q 

libpixanVideoDisplay(3H) 

mctrl(8) 

libpixar:ChapWait(3H) 

libpixanDbOpen(3H) 

libpixanDumiOpen(3H) 

libpixanMctrlOpen(3H) 

libpirl:PirlShear(3H) 

libpx:PW Shear(3C) 

intro(l) 

Iibpirl:PirlShift(3H) 

libpt:PWShift(3Q 

libpiri:PiriShuffle(3H) 

libpt:PWShuffle(3C) 

libpt:SICopy(3Q 

libpip:PWMap(3C) 

libpirl:PiriMapComp(3H) 

libpt:TBCopy(3C) 

libpx:SSHalve(3C) 

chsize(l) 
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Permuted Index 


- determine the smallest rectangle that surrounds an image.libpip:PWBBox(3C) 

- determine the smallest rectangle that surrounds an image. .libpirl:PirlBBox(3H) 

window. - swap the source pixel window and the destination pixel .libpirl:PirlSwap(3H) 

window.. - swap the source pixel window and the destination pixel .libpt:PWSwap(3C) 

- resize source pixel window to destination pixel window.libpx:PWResize(3C) 

window. - copy the source pixel window to the destination pixel.libpirl:PirlResize(3H) 

- warp source to target. .. . libpx:stwarp(3C) 

scanline backwards from alpha fb channel to spad channel array. - copy vertical ..libpt:FCCopy(3C) 

copy vertical scanline from arbitrary fb channel to spad channel array. -.libpt:FRGBACopy(3C) 

scanline backwards from alpha fb channel to spad integer array. - copy vertical.libpt:FICopy(3C) 

- merge pixels using spad matte.libpt:SSPaint(3C) 

window. - call a spad-to-spad routine for each line of a pixel .libpt:PWGeneric(3C) 

- SSCopy with specified channel rotation.libpt:SSShuffle(3C) 

fraction. - compute approximate 4-way reciprocal square root of unsigned 32-bit double-precision.libpm:recsqrt(3Q 

- compute approximate 4-way square root of unsigned 32-bit integer. .libpm:sqrt(3C) 


channels. SSRtoRGBA, SSGtoRGBA, SSBtoRGBA, SSAtoRGBA: Copy one channel from scratchpad to 4 .... libpt:SSCopyRGBA(3C) 

SSRtoRGBALUT, SSGtoRGBALUT, SSBtoRGBALUT, SSAtoRGB ALUT: Copy one channel from scratchpad to 4/ . . libpt:SSCopyRGBALUT(3C) 
scratchpad to 4 channels. SSRtoRGBA, SSGtoRGBA, SSBtoRGBA, SSAtoRGBA: Copy one channel from .... libpt:SSCopyRGBA(3C) 

scratchpad to 4/ SSRtoRGBALUT, SSGtoRGBALUT, SSBtoRGBALUT, SSAtoRGB ALUT: Copy one channel from libpt:SSCopyRGBALUT(3C) 


- SSCopy with specified channel rotation.libpt:SSShuffle(3C) 

from scratchpad to 4 channels. SSRtoRGBA, SSGtoRGBA, SSBtoRGBA, SSAtoRGBA: Copy one channel . libpt:SSCopyRGBA(3C) 

one channel from scratchpad to 4/ SSRtoRGBALUT, SSGtoRGBALUT, SSBtoRGBALUT, SSAtoRGBALUT: Copy libpt:SSCopyRGBALUT(3C; 

to another channel. SSRRRRtoRRRR,...: Copy one channel from scratchpad . . . libpt:SSCopyComp(3C) 
one channel from scratchpad to 4 channels. SSRtoRGBA, SSGtoRGBA, SSBtoRGBA, SSAtoRGBA: Copy libpt:SSCopyRGBA(3C) 
SSAtoRGBALUT: Copy one channel from scratchpad to/ SSRtoRGBALUT, SSGtoRGBALUT, SSBtoRGBALUT, . . libpt:SSCopyRGBALUT(3C) 
and restore all volatile registers from scratchpad stack. - save ...libpg:stack(3C) 

- PirlCopy with user-specified axes, start and direction parameters.libpirl:PirlCopy(3H) 

- PWCopy with user-specified axes, start and direction parameters.libpt:PWCopy(3C) 

- download a Chap object file and start it running.chload( 1) 

- dynamically load and start up a file in the Chap.libpixar:ChapLoadGo(3H) 

- reset Chap and framebuffer state...libpixar:ChapReset(3H) 

- read/write Chap runflag state.libpixar:ChapStack(3H) 

- read/write Chap crossbar state.HbpixanChapXbar(3H) 

-set video controller display state.libpixanVideoDisplay(3H) 

- set up filter coefficients for subsequent hdl or vdl.libpx:SSScale(3Q 

- add, subtract, multiply and divide scratchpad arrays.libpip:PWArithmetic(3C) 

- add, subtract, multiply and divide scratchpad arrays.libpip:SSArithmetic(3C) 

window. - subtract pixel value from 1.0 (0x800) for a pixel .libpiri:PirlNot(3H) 

window. - subtract pixel value from 1.0 (0x800) for a pixel .libpt:PWNot(3C) 

- memory management support ...libpg:mman(3Q 

- memory management support ...zzsave:mman(3C) 

- determine the smallest rectangle that surrounds an image.libpip:PWBBox(3C) 

- determine the smallest rectangle that surrounds an image.libpirl:PirlBBox(3H) 

pixel window. - swap the source pixel window and die destination.libpiri:PirlSwap(3H) 

pixel window.. - swap the source pixel window and the destination.libpt:PWSwap(3C) 

SYCopy.libpt:SYCopy(3Q 

- Chap runtime symbol table.chapsym(5) 

-display Chap symbol table.chmap(l) 

- Chap symbol table routines.libpixar:ChapSym(3H) 

-Chap sysbus register routines.libpixanChapReg(3H) 

- Chap runtime symbol table.. chapsym(5) 

- display Chap symbol table.chmap( 1) 

4-way mapping of scratchpad values using a mapping table. - .libpt:SS4Map(3Q 

from scratchpad to 4 channels through a color table. /SSAtoRGBALUT: Copy one channel .libpt:SSCopy RGB ALUT (3C) 

- initialize quadratic warping table. . ..libpx:stwarptable(3Q 

-Chapsymbol table routines...libpixar:ChapSym(3H) 

- map a single component through a color table to form a color image.libpip:PWMap(3Q 

- map a single component through a color table to form a color image.libpirl:PirlMapComp(3H) 

-initialize the pixar and the configuration tables..pixinit(l) 

- Take the histogram of a picture.hg(l) 

- warp source to target .. libpx:stwarp(3C) 

- merge two pixel windows into a third.. libpt:PWMerge(3C) 

- merge two frame buffer windows onto a third.merge(l) 

Copy one channel from scratchpad to 4 channels through a color table. /SSAtoRGBALUT: ..libpt:SSCopyRGBALUT(3C) 

- map a single component through a color table to form a color image.libpip:PWMap(3Q 

- map a single component through a color table to form a color image. ..libpirl:PirlMapComp(3H) 

- copy a single tile between locations in frame buffer memory.libpt:TBCopy(3C) 

- cleans out the tile block area.. libpt:TB(3C) 

- sequential decoding of tile from disk. ..!ibpicio:PicDecode(3H) 

- tile to buffer I/O..libpicio:PicRead(3H) 

-sequential encoding of a tile to disk. ... libpicio:PicEncode(3H) 

- Chap configuration tool.. . ....chconfig(8) 

- framebuffer animation tool.loop( 1) 

-framebuffer tool. ..... tool(l) 


- introduction to Chap Pixel Transfer Library.. libpt:libpt(3C) 

- introduction to Pixar image transformation library.libpx:libpx(3C) 
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Permuted Index 


- scratchpad to scratchpad merge using 

- Make a new pixel window 

- begin/end a dynamic load or 
- convert red-green-blue values to 

values, -convert 

compute approximate 4-way reciprocal square root of 
— compute approximate 4-way square root of 

- setup a disk buffer device for 
- setup a Dumi device for diagnostic 

- setup a memory controller device for diagnostic 
parameters. - PirlCopy with 
parameters. -PWCopywith 

- 4-way mapping of scratchpad values 

- merge pixels 

- scale pixels 

- scratchpad to scratchpad merge 

- introduction to shell-level Pixar 

- video board 

-copy 
- resize 

frame buffer in increasing y order to a component 
- clear an integer array to a single channel 

- subtract pixel 

- subtract pixel 

unnormalized CIE coordinates to red-green-blue 

- find the minimum and maximum 
- find the minimum and maximum pixel 

— find the minimum and maximum 

- convert red-green-blue 

- clamp pixel 

- convert red-green-blue 

- 4-way mapping of scratchpad 

- display an image from raster files of 

- set up filter coefficients for subsequent hdl or 

- multiply a double-precision 

- compare a Chap object file to the downloaded 

- reflect the pixel window around its center 

to spadchannel array, -copy 
to spad integer array, -copy 
scratchpad. - copy partial 
channel array, - copy 
/array to frame buffer IFyCopy - copy partial 

- clear partial 

- ramp framebuffer window horizontally or 


- open/close a 

- get/set the 

- set the location of a 

-Pixar 
- get/set 
- set 

- save and restore all 

- initialize quadratic 

- divide two pixel 

- set a pixel 

- merge two pixel 
- merge two frame buffer 


- circular shift pixel window contents in 

- circular shift pixel window contents in 

- circular shift pixel window contents in x and/or 

- circular shift pixel window contents in x and/or 

from scratchpad to frame buffer in increasing 
- clear frame buffer in increasing 


transpose a pixel window around the diagonal axis, 
transpose a pixel window around the diagonal axis. 

type out picture file information. 

UNDER operator. 

under Pirl. 

unload. 

unnormalized CIE coordinates. 

unnormalized CIE coordinates to red-green-blue 
unsigned 32-bit double-precision fraction. - . . 

unsigned 32-bit integer. . 

use. 

use. 

use.. 

user-specified axes, start and direction .... 
user-specified axes, start and direction .... 

using a mapping table. 

using spad matte.. 

using the formula A*x+B. 

using UNDER operator. .. 

utilities. 

utility. 

utility for portions of the framebuffer. .... 
utility for portions of the framebuffer. .... 

value, -clear. 

value. 

value from 1.0 (0x800) for a pixel window. . . 
value from 1.0 (0x800) for a pixel window. . . 

values. - convert . 

values in a pixel window. 

values in a pixel window. 

values in a scratchpad array. 

values to CIE coordinates. 

values to the range [0,1.0E].. 

values to unnormalized CIE coordinates. . . . 

values using a mapping table. 

various formats. 

vdl. 

vector list by a double-precision matrix. 

version. 

vertical axis. 

vertical scanline backwards from alpha fb channel 
vertical scanline backwards from alpha fb channel 
vertical scanline backwards from frame buffer to 
vertical scanline from arbitrary fb channel to spad 
vertical scanline from scratchpad integer array to/ 

vertical scanline in frame buffer. . 

vertically.. . 

video board utility. . .. 

video colorbar generator. . 

video controller. . 

video controller color map. 

video controller cursor. 

video controller device interface. 

video controller display format. 

video controller display state. 

volatile registers from scratchpad stack. 

warp source to target. 

warping table. 

windows. 

window’s channel mask.. 

windows into a third. 

windows onto a third.. 

write a Chap alu register. . 

write/read Chap resources. 

x and/or y. 

x and/or y. 

y.... . 

y. 

y order. - copy component . 

y order to a component value. 

YFCopy. 

YSCopy. 

Zoom in on a pixel window on the monitor. . . 


libpirl:PirlTranspose(3H) 

libpt:PWTranspose(3C) 

gtinfo(l) 

libpt:SSMerge(3C) 

libpiri:PirlNewPW(3H) 

libpixar:ChapLoad(3 H) 

libcolonrgb2XYZ(3C) 

libcolonXYZ2rgb(3C) 

libpm:recsqrt(3C) 

libpm:sqrt(3C) 

libpixar:DbOpen(3H) 

libpixar:DumiOpen(3II) 

libpixar:MctrlOpen(3H) 

libpirl:PirlCopy(3H) 

libpt:PWCopy(3C) 

libpt:SS4Map(3C) 

libpt:SSPaint(3C) 

libpt:SSAxb(3C) 

libpt:SSMerge(3C) 

intro(l) 

video(l) 

copy(l) 

resize(l) 

libpt:CFCopy(3C) 

libpt:SICopy(3C) 

libpirl:PirlNot(3H) 

libpt:PWNot(3C) 

libcolor:XYZ2rgb(3C) 

libpip:PWRange(3C) 

libpirl:PirlRange(3H) 

libpip:SSRange(3C) 

libcolonigb2xy Y (3C) 

libcolor:SSClamp(3C) 

libcolor:rgb2XYZ(3C) 

libpt:SS4Map(3C) 

see(l) 

libpx:SSScale(3C) 

libpm:matrix(3C) 

chcmp(l) 

libpirl:PirlReflect(3H) 

libpt:FCCopy(3C) 

Iibpt:FICopy(3C) 

libpt:FSCopy(3C) 

libpt:FRGBACopy(3C) 

libpt:IFCopy(3C) 

libpt:SFCopy(3C) 

ramp(l) 

video(l) 

cbars(l) 

HbpixanVideoOpen(3H) 
libpixarVideoCmap(3H) 
libpixar: VideoCursor(3 H) 
video(4) 

libpixanVideoFormat(3H) 

libpixar:VideoDisplay(3H) 

libpg:stack(3C) 

libpx:stwarp(3C) 

libpx:stwarptable(3C) 

libpirl:PirlArithmetic(3H) 

libpirl:PirlSetChannelMask(3H) 

libpt:PWMerge(3C) 

merge(l) 

libpixar:ChapAlu(3H) 

libchad:ChadWrite(3H) 

libpirl:PirlShift(3H) 

libpt:PWShift(3Q 

libpirl:PirlShift(3H) 

libpt:PWShift(3Q 

libpt:RGBAFCopy(3C) 

libpt:CFCopy(3Q 

libpt:YFCopy(3C) 

libpt:YSCopy(3C) 

libpirl:PirlZoom(3H) 
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Pixar Programmer’s Manual 


INTRO (1) 


NAME 

intro - introduction to shell-level Pixar utilities 

DESCRIPTION 

This section describes the shell-level programs for interacting with the Pixar Image Computer. 

Many frame buffer programs accept the following options. 

-fb fbname 

Most of these programs will read the FBDEFS environment variable for finding the default frame 
buffer window. Specify a frame buffer window on a command line using the -fb fbname option. 
It is either a string delimited by "" (quotation marks), or a frame buffer as defined in the 
LFBDEFS environment variable. This option is described in more detail in fbdefs(l ) and 
FbGetDefsi 3H). 

-srcfb fbname 
-tmpfb fbname 
-dstfb fbname 

Many programs use source, temporary and destination frame buffers rather than a single -fb 
option. Specify these frame buffer windows in the same manner as for the -fb option. If any of 
srcfb, dstfb, or tmpfb are not specified, but their corresponding windows are specified, they will 
each default to the FBDEFS environment variable. If any of srcfb, dstfb, or tmpfb are not 
specified, nor are their corresponding windows, then srcfb will default to dstfb, dstfb will 
default to srcfb, and tmpfb will default to dstfb. If none of these are specified, the program will 
read the FBDEFS environment variable for finding the default frame buffer window. This set up 
may sound complicated, but in practice yields the most intuitively expected results. 

-w xmin xmax ymin ymax 

Denotes a subwindow of the frame buffer, expressed relative to the top left comer of the frame 
buffer. 

-src xmin xmax ymin ymax 
-tmp xmin xmax ymin ymax 
—dst xmin xmax ymin ymax 

Denotes subwindows of frame buffers srcfb, tmpfb and dstfb respectively, expressed relative to 
the top left comer of their respective frame buffers. 

~ch selectchan 

The channel select option; sets a write mask for the window, selectchan is a sequence of 1 to 4 
characters from the set {r, g, b, a, R, G, B, A}, without repetition. For example; -ch rb will select 
the red and blue channels, -ch a selects only die alpha channel, -ch aGrB will select all four 
channels. 

-shuffle shufflechan 

The channel shuffle option; sets a permutation of the channels for the window, shufflechan is a 
sequence of 4 characters from the above set, for example: RRRR gbaA rgrg are all legal. 

Where used, the optional argument color is short for the usual color specification [red [green blue [alpha]]], 
where the color (0,0,0,0) is assumed if the argument is not given, the color (red, red, red, red) is assumed 
if only red is specified, and the color (red, green, blue, 0) is assumed if alpha is not specified. 

Many of these programs do not deal with the frame buffer at all; among these are the Chap assembler, 
linker and loader. 

SEE ALSO 

intro(3H), intro(3C) 
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INTRO(l) 


OPMENT 

TOOLS 

Name 

Page 

charm 

charm.l 

chas 

chas.l 

chc 

chc.l 

chcmp 

chcmp. 1 

chd 

chd.l 

chid 

chld.1 

chload 

chload. 1 

chmap 

chmap. 1 

chnm 

chnm.l 

chranlib chranlib.l 

chsize 

chsize. 1 

dumi 

dumi.l 

ICS TOOLS 

Name 

Page 

blur 

blur.l 

cbars 

cbars. 1 

cha 

chad 

clamp 

clamp. 1 

clr 

clr.l 

conv 

conv.l 

copy 

copy.l 

crc 

crc.l 

gamma 

gamma. 1 

gt 

gtl 

gtinfo 

gtinfo. 1 

guide 

guide. 1 

hg 

hg.l 

loop 

loop.l 

merge 

merge. 1 

perm 

perm.l 

pixinit 

pixinit 1 

ramp 

ramp.l 

resize 

resize. 1 

rotate 

rotated 

scale 

scaled 

see 

seed 

sv 

sv.l 

tool 

tool.1 

video 

video.l 


Description 

- Chap runtime monitor 

- Chap assembler 
• - Chap compiler 

- compare a Chap object file to the downloaded version 

- Chap disassembler 

- Chap link editor 

- download a Chap object file and start it running 

- display Chap symbol table 

- print name list of a Chap object file 

- convert archives to Chap random libraries 

- size of a Chap object file 

- examine and modify Dumi registers 


Description 

- applies a box filter to the framebuffer 

- video colorbar generator 

- perform linear arithmetic on framebuffer channels 

- clamp the contents of a framebuffer to [0..2048] 

- framebuffer clear 

- convolve a framebuffer image with a 3x3 filter 

- copy utility for portions of the framebuffer 

- compute a Cyclic Redundency Check (CRC) on a framebuffer 

- set gamma-corrected colormap 

- get a frame buffer image from a picture file 

- type out picture file information 

- display fieldguide in framebuffer 

- Take die histogram of a picture 

- framebuffer animation tool 

- merge two frame buffer windows onto a third 

- permutations of the frame buffer 

- initialize the pixar and the configuration tables 

- ramp framebuffer window horizontally or vertically 

- resize utility for portions of the framebuffer 

- rotate utility for portions of the framebuffer 

- scale framebuffer RGBA intensitiesn 

- display a frame buffer image from a variety of types of picture file 

- save frame buffer into picture file 

- framebuffer tool 

- video board utility 
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NAME 

charm - Chap runtime monitor 

SYNOPSIS 

charm [ -x ] [ -I dir ] [ chap-device j 
DESCRIPTION 

charm is the Chap runtime monitor. With charm a user may interactively interrogate the state of a Chap, 
load and link-edit Chap code, and control the execution of programs running in a Chap, charm uses the 
Chap diagnostic interface and the facilities described in chap (4). 

Options: 

-x instructs charm to open the specified (or default) Chap device with exclusive access; this overrides 
the normal shared access. 

-I may be used to specify directories in which files to be read with $< or $« (see below) may be 
found. Normally, charm searches only in the directory “/usr/pixar/lib/charm”. Multiple direc¬ 
tories may be specified in this way. A specific Chap may be designated using Chap device; charm 
uses “/dev/chapO” by default. 

charm ignores QUIT signals; INTERRUPT signals cause return to the next charm command. 

When charm is ready to accept commands from the keyboard, it prompts with “> ” and waits for input. In 
general, requests to charm are of the form 

[address] [,count] [command] [;] 

If address is present, the current address, referred to as “dor”, is set to address. Initially, dot is set to 0. 
For most commands count specifies how many times the command should be executed. The default count 
is 1. address and count may be expressions. 

EXPRESSIONS 

charm processes two types of expressions: those involving scalar quantities, and those involving vectors (of 
length 4). Where two scalar expressions are combined, the obvious arithmetic is performed. Combining 
two vector expressions results in a component-by-component application of the appropriate operator. 
When a vector and a scalar are combined, the scalar is combined with each element of the vector to gen¬ 
erate a vector result. Constants are considered scalars. 4-way registers (e.g., the ALU accumulator) are 
treated as vector expressions. 

The value of dot. 

+ The value of dot incremented by the current increment 

The value of dot decremented by the current increment. 

The last address typed. 

integer A number. The prefixes “Ox” and “OX” force interpretation in hexadecimal radix; the prefix 
“0” forces interpretation in octal radix; “Ot” and “0T” force interpretation in decimal radix. If 
no prefix appears, then the default radix is used; see the $d command. The default radix is ini¬ 
tially decimal. The hexadecimal digits are 0123456789abcdefABCDEF with the obvious values. 

integer.fraction 

A 16-bit Pixar fixed-point number. If the fraction is followed by an e or E, the number is treated 
as a component value (eleven bits of fraction). If the fraction is followed by an f or F, the 
number is treated as a coefficient value (fourteen bits of fraction). By default, fixed-point 
numbers are treated as component values. The integer portion of a fixed-point number must be 
specified in base ten, either explicitly with a “Ot” prefix, or implicitly by setting the input radix 
to 10; see the $d command. 

<name The value of name , which is either a variable name or a register name, charm maintains 36 vari¬ 
ables: a-z and 0-9. The register names are the same as those used by the Chap assembler; §4.4 of 
the Charm Reference Manual provides a complete list. 
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symbol A symbol is a sequence of upper or lower case letters, underscores or digits, not starting with a 
digit. The backslash character \ may be used to escape other characters. The value of the symbol 
is found by first checking the list of known registers then, failing there, looking in the symbol 
table. 

(exp) The value of the expression exp. 

Monadic Operators 

*exp The contents of the tessellated scratchpad location addressed by exp. 

@exp The contents of the untessellated scratchpad location addressed by exp. 

-exp Integer negation. 

“exp Bitwise complement. 

lexp Logical negation. 

Dyadic Operators 

Dyadic operators are left associative and less binding than monadic operators. 

el+e2 Integer addition. 

el-e2 Integer subtraction. 

el *e2 Integer multiplication. 

el%e2 Integer division. 

el&e2 Bitwise conjunction. 

el\e2 Bitwise disjunction. 

el#e2 Round el up to the next multiple of e2. 

COMMANDS 

Most commands consist of a verb followed by a modifier or list of modifiers. The following verbs are 
available. 

?/ Locations starting at address in instruction RAM are printed according to the format/, dot is 
incremented by the sum of the increments for each format letter. 

If Locations starting at address in scratchpad RAM are printed according to the format / and dot is 
incremented as for “?”. 

=/ The value of address itself is printed in the styles indicated by the format/. (This may not be used 
with the i format.). 

A format /, consists of one or more characters that specify a style of printing. Each format may be pre¬ 
ceded by a decimal integer that is a repeat count for the format letter. While stepping through a format, dot 
is incremented by the amount given for each format letter. If no format is given, the last format is used. 

Lower-case letter formats used with the / operator force charm to interpret the address as a tessellated 
address; upper-case letters cause the address to be interpreted as un-tessellated. 

The format letters available are as follows: 

o Print the value in octal (O for untessellated). 

d Print the value in decimal (D for untessellated). 

x Print the value in hexadecimal (X for untessellated). 

u Print the value as an unsigned decimal number (U for untessellated). 

e Print the value as an 11-bit fixed point number (E for untessellated). 

f Print the value as a 14-bit fixed point number (F for untessellated). 

i Print the value as a machine instruction. 

a Print the value of dot in symbolic form. Symbols are checked to ensure that they have an 
appropriate type as indicated below: 
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/local or global data symbol 
?local or global text symbol 
=local or global absolute symbol 
(A for untesselated). 

p Print the addressed value in symbolic form using the same rules for symbol lookup as a (P for 
untessellated). 

b Print the value of dot in the form pixel .component, where the specified component is one of 
“RGB A” (B for untessellated). 

z Print the addressed value in the form pixel.component , as for the b format (Z for untessellated). 
t When preceded by an integer, tabs to the next appropriate tab stop. For example, 8t moves to the 
next 8-space tab stop, 
r Print a space, 

n Print a newline. 

"..." Print the enclosed string. 

dot is decremented by the current increment; nothing is printed. 

+ dot is incremented by 1; nothing is printed. 

- dot is decremented by 1; nothing is printed. 

c Print the value as an ASCII character. Control characters are printed as A X and the delete charac¬ 
ter is printed as A ?. 

s n Print a string of characters (terminated by a null byte). 
newlineR 

Repeat the previous command with a count of 1. 

[?/]w value ... 

Write a 1-word value into the addressed locations. If the command is W, the address is treated as 
untessellated. If the address expression is 4-way, the value is written to each of the four com¬ 
ponents. Multiple values are written into consecutive locations. If a count is specified, the write 
command is repeated count times with dot incremented each time (useful for clearing a block of 
scratchpad). 

>name dot is assigned to the variable or register named. If a 4-way register is specified and dot is a scalar 
expression, its value is assigned to each component of the register. Assigning a vector expression 
to a variable causes it to be treated later as a vector expression. 

%modifier 

Miscellaneous printing commands. The available modifiers are: 

<f Read commands from the file /. If this command is executed in a file, further commands 
in the file are not seen. If/is omitted, the current input stream is terminated. If a count is 
given, and is zero, the command will be ignored. The value of count will be placed in 
variable 9 before the first command in/is executed. 

«f Similar to < except it can be used in a file of commands without causing the file to be 
closed. Variable 9 is saved during the execution of this command and restored when it 
completes. There is a (small) finite limit to the number of « files that can be open at 
once. 

>/ Append output to the file/, which is created if it does not exist. If/is omitted, output is 
returned to the terminal. 

a Print the scratchpad address registers. If count is specified, only the first count registers 
are displayed. 

b Print all breakpoints and their associated counts and commands. 

c Print a stack backtrace. The backtrace shows the value of the pc, 1c, and runflag at each 
level in the stack. If count is given, then only the first count frames are printed. If 
address is specified, the backtrace commences at that stack level. 
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d Set the default radix to address and report the new value. Note that address is interpreted 
in the (old) current radix. If no radix is specified, charm reports the the current radix. 

e Print the names and values of external symbols. If an address is specified, it is inter¬ 
preted as a symbol table type; the possible values are: 2 ( absolute symbols), 4 ( text sym¬ 
bols), 6 ( data symbols), and 8 (bss symbols). 

1 Print the names and values of local symbols. Any address specified is interpreted as for 
e. 

m Print the segment (load) map. 

p Print the contents of the Pbus registers and the Pbus data buffer. If count is given, only 
the first count entries in the Pbus data buffer are displayed. 

q Exit from charm ($Q and *D work as well). 

r Print the registers of each ALU, the loop counter, the stack pointer, and the instruction 

addressed by the pc. dot is set to pc. If address is specified, it is interpreted as a bitmask 
of processors for which ALU registers should be displayed. If count is given, only the 
first count ALU registers are displayed. 

u Print the name of each unresolved symbol and the modules in which the symbols are 
referenced. 

v Print all non-zero variables in hexadecimal. 

x Print the contents of the crossbar. 

y Print the contents of the Yapbus registers. 

S Set the limit for symbol matches to address (default 255). 

W Set the page width for output to address (default 80). 
modifier 

Manage the execution of the Chap. The available modifiers are: 

be Set a breakpoint at address. The breakpoint is executed count- 1 times before causing a 
stop. Each time the breakpoint is encountered the command c is executed. If this com¬ 
mand is omitted or sets dot to zero, then the breakpoint causes a stop. 

d Delete the breakpoint at address. 

c The Chap is continued. If address is given, then the processor is continued at this 
address. Breakpoint skipping is the same as for r. 

fc Specify a set of commands c to be executed each time the Chap is stopped by a : com¬ 
mand. More explicitly, the “format” commands are executed after each single-step 
next, run, continue, or halt command is completed. If a command string is not specified 
the current one is displayed. 

h Halt the Chap. 

If Load and bind a chas output file /. charm will try to resolve any undefined externa 
references in /from code currently resident in the Chap. Failure to resolve references i: 
reported on the standard output The file is searched for in the list of directories showr 
with the :p command. If a file is not specified, the last file specified in a :u or :1 com 
mand is used. If no “last file” is available, charm tries to load the file “chap.out”, oj 
failing, “chas.out”. 

n As for :s except that if the current instruction contains a jump to subroutine sequence] 
instruction, the subroutine is run at full speed with the Chap halted at the instructioi 
immediately following the return. If the Chap had not previously been started with an i 
command, the n command will do this. 
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P P Set the “load searchpath’* to p. The path is a list of directories in which to search for 

loadable files. Searchpaths must be separated by colons. If no path is specified, the 
current load path is displayed. The default load path is “.:/usr/lib:/usr/pixar/lib’’. 

r Begin execution of the Chap. If address is given explicitly, then the program is entered 
at this point; otherwise the program is entered at its standard entry point Count specifies 
how many breakpoints are to be ignored before stopping. 

s As for :c except that the Chap is single stepped count instructions. If the Chap had not 
previously been started with an r command, die s command will do this. 

u/ Unload the file/. That is, reclaim the instruction and scratchpad memory associated with 
file and remove the related allocation information from the symbol table. When no file is 
specified, charm searches for a file as described under the :1 command. 

VARIABLES 

charm provides a number of variables. Certain named variables are set initially by charm and used in the 
print commands (see below). Numbered variables are used to communicate various dynamically changing 
values. 

0 The last value printed. 

1 The last immediate field of an instruction. 

2 The previous value of variable 1. 

9 The count on the last $< or $« command. 

a Number of registers to print with the $a command. 

f ‘ ‘Runflag’ ’ to use in limiting printing with the $r command. 

p Number of data buffer entries to print with the $p command. 

r Number of registers to print with the $r command. 

s Number of registers to print with the $s command. 

REGISTERS 

charm allows Chap data registers to be referred to symbolically. Register names are identical to those used 
by the Chap assembler chas wherever possible. A component of a vector register may be specified with 
[exp], where exp is an expression as described above. A sysbus register is specified, as in chas , 
sysbus<exp> where, once again, exp ism expression. The following list shows the names of registers as 
understood by charm. 


aO, al 

Pbus address registers 


acc 

ALU accumulator 

4-way 

admux 

address portion of the crossbar 

4-way 

bO,...»bl5 

Scratchpad base address registers 


iO,..., il5 

Scratchpad index registers 


lc 

Loop counter 


Isp 

Least significant part of multiplier output 

4-way 

msp 

Most significant part of multiplier output 

4-way 

multx 

Multiplier X-input 

4-way 

multy 

Multiplier Y-input 

4-way 

pc 

Program counter 


pcsr 

Pbus control status register 


rO,...»r31 

ALU internal registers \ 

4-way 

rdmux 

read portion of the crossbar 

4-way 

rf 

Runflag 


sp 

Stack pointer 


sysbus 

Sysbus shared data register 


status 

Chap status register 


wrmux 

write portion of the crossbar 

4-way 

ycsr 

Yapbus control status register 



Release 1.2 


July 8,1986 


5 



CHARM (1) 


Pixar Programmer’s Manual 


CHARM(l) 


FILES 

/dev/chapO default Chap device to use 
/usr/pixar/host/bin/charm 

SEE ALSO 

chc(l), chas(l), intro(3H), ChapLoad(3H), chap(4G), chap.out(5) 

DIAGNOSTICS 

Types ‘Charm* when there is no current command or format. Comments about inaccessible files, syntax 
errors, etc. Exit status is 0, unless the last command failed or returned nonzero status. 

BUGS 

The $c command sometimes doesn’t work. You can’t write instruction memory. 
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NAME 

chas - Chap assembler 

SYNOPSIS 

chas [ -wsS ] [ -o output ] [ file ] 

DESCRIPTION 

chas is an assembler for the Chap, chas takes one or more input files (or standard input if no files are 
specified) and generates a relocatable object file suitable for use with the Chap link editor, chld(l\ or 
dynamic loader, ChapLoad( 3H). chas is most normally accessed through the chc(l) program, which first 
passes the input file through the C preprocessor. The options to chas are: 

-w Suppress warning messages. 

-s Enable messages indicating new instructions generated as the result of the special bit 
-S Print the symbol table after all input has been processed. 

-o Place the relocatable object file in output instead of the default file chas.out. 

FILES 

chas.out default name for output file 
/usr/pixar/host/bin/chas 

SEE ALSO 

Chap Assembler Reference Manual 
chc(l), chld(l), ChapLoad(3H) 

BUGS 

Incorrect relocation information is generated for “loop” constructs using expressions that require the spe¬ 
cial bit Statements that cause chas to generate a special bit instruction, and that modify operands to be 
supplied to the ALU, are not handled correctly. 
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NAME 

chc - Chap compiler 

SYNOPSIS 

chc [ options ] [ files ] 

DESCRIPTION 

chc is the Chap compiler (more of an assembler than anything else), chc accepts several types of argu¬ 
ments. 

Arguments whose names end with ‘.s’ are taken to be Chas source programs; they are assembled, and each 
object program is left in a file whose name is that of the source with ‘.o’ substituted for ‘.s’. The ‘.o’ file is 
normally deleted if a single Chas program is compiled and loaded all at once (see -c option below). 

The following options are interpreted by chc. See chld(\) for load-time options. 

-c Suppress the loading phase of the compilation, and force an object file to be produced even ii 
only one program is compiled. 

-w Suppress warning diagnostics. 

-E Run only the macro preprocessor on the named Chas programs, and send the result to the stan¬ 
dard output. 

-C Prevent the macro preprocessor from removing comments. 

-o output 

Name the final output file output. If this option is used, the file ‘chap.out’ will be left undis¬ 
turbed. 


-Dname=def 

Define the name to the preprocessor, as if by ‘#define’. If no definition is given, the name is 
defined as “1”. 


—\J+Sname 

Remove any initial definition of name. 

-I *Sdir ‘#include’ files whose names do not begin with 7’ are always sought first in the directory of the 

file argument, then in directories named in -I options, then in directories on a standard list 

Arguments are taken to be either loader option arguments, or Chas-compatible object programs, typicall) 
produced by an earlier chc run, or perhaps libraries of Chas-compatible routines. These programs, togethei 
with the results of any compilations specified, are loaded (in the order given) to produce an executable pro¬ 
gram with the name chap.out. 


FILES 

file.s 

file.o 

chap.out 

/tmp/chas? 

/lib/cpp 

/usr/pixar/host/bin/chas 

/usr/pixar/host/bin/chc 

/usr/pixar/host/bin/chld 

/usr/pixar/include 


input file 
object file 
loaded output 
temporary 
preprocessor 
assembler 
compiler 
loader 

standard directory for ‘#include’ files 


SEE ALSO 

charm(l), chld(l), chas(l) 


DIAGNOSTICS 

The diagnostics produced by Chas itself are intended to be self-explanatory. Occasional messages may be 
produced by the loader. 


] 
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NAME 

chcmp - compare a Chap object file to the downloaded version 

SYNOPSIS 

chcmp [ -s ] [ -1 ] [ -f device ] [ file] 

DESCRIPTION 

chcmp compares the contents of a Chap object file against the contents of instruction and scratchpad 
memories. If no object file is specified, chcmp tries to use chap.out or (failing) chas.out. The default dev¬ 
ice is /dev/chapO. 

Options: 

-f Used to specify an alternate device. 

-1 Normally, chcmp will report the first place where the two files differ, then exit. If the -1 flag is 
specified, chcmp will report all differences. 

-s If specified, chcmp will produce no output; instead its termination status will indicate whether the 
files compare. 

FILES 

/usr/pixar/host/bin/chcmp 

chap.out 

chas.out 

/dev/chapO 

SEE ALSO 

chap.out(5), chload(l), chld(l), chd(l) 

BUGS 

chcmp is useful only with chload(l). Chap object files that have been relocated by chid obviously will not 
compare “correctly”. 
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NAME 

chd - Chap disassembler 

SYNOPSIS 

chd [ -f ] [ -n ] [files] 

DESCRIPTION 

chd prints a listing of the specified Chap object files, disassembling instructions in the text segment. 
Options: 

-f If specified, each field of a Chap instruction that differs from the “default” value assigned it b) 
the assembler is displayed. 

-n If specified, chd does not print the customary text or data segment address in the first column; thi: 
is useful mostly for comparing object files with the UNIX command diff. 

When chd is invoked without specifying any object files, it tries to open the file “chap.out”. Should tha 
fail, chd will then try to open the file “chas.out”. 

FILES 

chap.out primary default input file 
chas.out secondary default input file 
/usr/pixar/host/bin/chd 

SEE ALSO 

charm(l), chas(l) 

DIAGNOSTICS 

The diagnostics are intended to be self-explanatory. 

BUGS 

chd uses an ancient disassembly algorithm which differs significantly from that used by charm{ 1); it shoulc 
be rewritten to use charm's algorithm and the symbol table associated with each object file. 
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NAME 

chid - Chap link editor 

SYNOPSIS 

chid [options] [file] 

DESCRIPTION 

chid combines several object programs into one, resolving external references, and searching libraries. In 
the simplest case, several object files are given, and chid combines them, producing an object module that 
can be either executed on a Chap or become the input for a further chid run. (In the latter case, the -r 
option must be given to preserve the relocation bits.) The output of chid is left on chap.out. 

The argument routines are concatenated in the order specified. The entry point of the output is the begin¬ 
ning of the first routine (unless the -e option is specified). 

If any argument is a library, it is searched exactly once at the point it is encountered in the argument list. 
Only those routines defining an unresolved external reference are loaded. If a routine from a library refer¬ 
ences another routine in the library, and the library has not been processed by chranlib(l), the referenced 
routine must appear after the referencing routine in the library. Thus, the order of programs within libraries 
can be important. The first member of a library should be a file named ‘_.SYMDEF’, which is under¬ 

stood to be a dictionary for the library as produced by chranlib( 1); the dictionary is searched iteratively to 
satisfy as many references as possible. 

The symbols ‘_etext’, ‘_edata’ and ‘_end’ are reserved, and, if referred to, are set to the first location above 
the program, the first location above initialized data, and the first location above all data respectively. It is 
erroneous to define these symbols. 

chid understands several options. Except for -1, they should appear before the file names. 

-A This option specifies incremental loading, i.e., linking is to be done in a manner so that the result¬ 
ing object may be read into an already executing program. The next argument is the name of a file 
whose symbol table will be taken as a basis on which to define additional symbols. Only newly 
linked material will be entered into the text and data portions of chap.out, but the new symbol 
table will reflect every symbol defined before and after the incremental load. This argument must 
appear before any other object file in the argument list. 

-T May be used as well as -A, and will be taken to mean that the newly linked segment will com¬ 
mence at the corresponding address (which must be a multiple of 1024). The default value is the 
old value of _end. 

-D Take the next argument as a hexadecimal number and pad the data segment with zero-filled bytes 
to the indicated length. 

-d Force definition of common storage even if the -r flag is present 

-e The following argument is taken to be the name of the entry point of the loaded program; location 

0 is the default 

-lx This option is an abbreviation for the library name ‘/usr/pixar/chap/lib/libx.a’ where x is a string. 
A library is searched when its name is encountered, so the placement of a -I is significant. 

-M Produce a primitive load map, listing the names of the files to be loaded. 

-o The name argument after -o is used as the name of the chid output file, instead of chap.out. 

-r Generate relocation bits in the output file, so it can be the subject of another chid run. This flag 

also prevents final definitions from being given to common symbols, and suppresses the 
‘undefined symbol’ diagnostics. 

-S ‘Strip’ the output by removing all symbols except locals and globals. 

-T The next argument is a hexadecimal number which sets the text segment origin. The default ori¬ 
gin is 0. 
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-t (“trace”) Print the name of each file as it is processed. 

-u Take the following argument as a symbol and enter it as undefined in the symbol table. This is 
useful for loading wholly from a library, since initially the symbol table is empty and an 
unresolved reference is needed to force the loading of the first routine. 

-X Save local symbols except for those whose names begin with ‘L\ This option is used by chc(l) to 
discard internally-generated labels while retaining symbols local to routines. 

-x Do not preserve local (non-.globl) symbols in the output symbol table; only enter external sym¬ 
bols. This option saves some space in the output file. 

-ysym Indicate each file in which sym appears, its type and whether the file defines or references it. 
Many such options may be given to trace many symbols. 

FILES 

/usr/pixar/chap/lib/x.a libraries 

chap.out output file 

/usr/pixar/host/bin/chld 

SEE ALSO 

chas(l), ar(l+), chc(l), chranlib(l) 


* See the appropriate UNIX programmer’s manual page.- 
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NAME 

chload - download a Chap object file and start it running 

SYNOPSIS 

chload [ -f device ] [ -h ] [ -r ] [ -s startsym ] [ -v ] [files] 

DESCRIPTION 

chload link-edits and relocates one or more relocatable object files created by chas( 1) or chld{\), down¬ 
loading the resulting program into a Chap. If the link-edit process is successful, the Chap is set running at 
the start of the first file. 

Options: 

-f Unless this is specified, chload downloads programs into /dev/chapO. 

-h Used to link-edit and load the files but not start the Chap running. 

-r Resets the symbol table before starting the loading process. 

-s Forces chload to start the Chap running at a specific location in the program when a symbol name 
is specified with the -s flag. 

-v Normally, chload operates quietly. The -v flag causes it to print messages regarding each file 
loaded out of a library and the location in instruction memory at which the Chap is set running. 

-lx This option is an abbreviation for the library name ‘/lib/libx.a\ where x is a string. If that does not 
exist. Id tries ‘/usr/lib/libx.a’. A library is searched when its name is encountered, so the place¬ 
ment of a -1 is significant (/usr/pixar/chap/Iib*.a). 

SEE ALSO 

chc(l), chld(l), ChapLoadGo(3H), ChapLoad(3H), chap.out(5) 
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NAME 

chmap - display Chap symbol table 

SYNOPSIS 

chmap [ -gbdtulrm ] [ -f device ] [ -i ] [ symbol-name ] 

DESCRIPTION 

chmap prints the symbol table associated with a Chap. This symbol table, used by the Chap link-editor 
loader chload(\), reflects the known contents of the Chap’s scratchpad and instruction memories. The 
default symbol table displayed is that associated with “/dev/chapO”; die -f flag may be used to specify an 
alternate device. If no arguments are specified chmap displays the entire contents of the symbol table. 
Otherwise, only the values of the specified symbols are shown. If a file name symbol is specified, chmap 
displays all the symbols defined in that file. 

Each symbol name is preceded by its value (blanks if undefined) and one of the letters U (undefined), A 
(absolute), T (text segment symbol), D (data segment symbol), B (bss segment symbol), or f file name. II 
the symbol is local (non-external) the type letter is in lower case. 

The following options may be used to specify only a subset of the symbols in the symbol table: 

-g Print only global (external) symbols. 

-b Print only symbols defined in bss segments. 

-d Print only symbols defined in data segments. 

-t Print only symbols defined in text segments. 

-u Print only undefined symbols. 

-1 Print only local (not external) symbols. 

-r May be used to force chmap to list the address and segment of each reference to a symbol. 

—m Displays a “load map” identical to the $m command of charm(\). This display shows each file 

that has been loaded into the Chap and the locations of the file’s segments. 

-f May be used to specify an alternate device . 

-i May be used to initialize the symbol table and the operating system resource allocation maps. 
While it is often useful for resetting the Chap, it should be used with care, since this request 
deletes all information about resident code and data. 

Text segment symbol values are divided by the size of a Chap micro-instruction. Data and bss segment 
symbol values are divided by two to give a word offset in scratchpad. 

FILES 

/dev/chapO default Chap device 

/usr/pixar/host/symtab/* symbol table files 

/usr/pixar/host/bin/chmap 

SEE ALSO 

chnm(l), chload(l), chapsym(5) 
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NAME 

chnm - print name list of a Chap object file 

SYNOPSIS 

chnm [ -gnopru ] [file ] 

DESCRIPTION 

chnm prints the name list (symbol table) of each Chap object file in the argument list If an argument is an 
archive, a listing for each object file in the archive will be produced. If no file is given, the symbols in 
“chap.out” are listed. 

Each symbol name is preceded by its value (blanks if undefined) and one of the letters U (undefined), A 
(absolute), T (text segment symbol), D (data segment symbol), B (bss segment symbol), Q (qualifier sym¬ 
bol), or C (common symbol), or f file name. If the symbol is local (non-external) the type letter is in lower 
case. The output is sorted alphabetically. 

Options are: 

-g Print only global (external) symbols. 

-n Sort numerically rather than alphabetically. 

-o Prepend file or archive element name to each output line, rather than only once. 

-p Don’t sort; print in symbol-table order. 

-r Sort in reverse order. 

-u Print only undefined symbols. 

Text segment symbol values are divided by the size of a Chap micro-instruction (96 bits). Data and bss 
segment symbol values are divided by two to give a word offset in scratchpad. 

SEE ALSO 

ar(l*), ar(5*), chap.out(5) 


* See appropriate page in UNIX Programmer’s Manual. 
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NAME 

chranlib - convert archives to Chap random libraries 

SYNOPSIS 

chranlib archive 

DESCRIPTION 

chranlib converts each archive to a form the Chap loader can load efficiently, chranlib does this by adding 

a table of contents called_.S YMDEF to the beginning of the archive, chranlib uses ar (1) to reconstruci 

the archive, so that sufficient temporary file space must be available in the file system that contains the 
current directory. 

FILES 

/usr/pixar/host/bin/chranlib 
SEE ALSO 

chld(l), ar(l*), lorder(l*) 

BUGS 

Because generation of a library by ar(l*) and randomization of the library by chranlib are separate 
processes, phase errors are possible. 


* See appropriate page in UNIX Programmer’s Manual. 
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NAME 

chsize - size of a Chap object file 

SYNOPSIS 

chsize [ object-file ] 

DESCRIPTION 

chsize prints the (decimal) sizes of the text, data, and bss portions, and their sum in hex and decimal, of 
each object-file argument. Text sizes are printed in terms of 96-bit instructions, while data and bss sizes 
are in terms of the 16-bit words. If no file is specified, chap.out is used. 

FILES 

/usr/pixar/host/bin/chsize 

chap.out 

SEE ALSO 

chap.out(5) 
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NAME 

dumi - examine and modify Dumi registers 

SYNOPSIS 

dumi [ iena ] [ -iena ] [ reset ] [ -reset ] [ init ] [ peek addr ] [ poke addr data ] 

DESCRIPTION 

dumi is a simple program used to peek and poke values into or through the Dumi interface. If no argu¬ 
ments are given, dumi prints the contents of the Dumi control status register. Arguments are interpreted as 
commands and processed one at a time as follows: 

iena Set the interrupt enable bit in the csr. 

-iena Clear the interrupt enable bit in the csr. 
reset Set the reset bit in the csr. 

-reset Clear the reset bit in the csr. 

init Initialize the Dumi by setting the reset and interrupt enable bits in the csr. 
peek Display the value in Sysbus address addr. 

poke Try to poke the specified data value into the location at the given Sysbus addr . 

dumi catches faults generated by peeks and pokes on the Sysbus and prints the message “Bus error”. 

This program is useful as a hardware diagnostic aid. Use of this program should normally be limited to 
that purpose. 

FILES 

/usr/pixar/host/bin/dumi 

SEE ALSO 

dumi(4), mctrl(8) 
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NAME 

blur - applies a box filter to the framebuffer 

SYNOPSIS 

blur [[height] width] [options] 

DESCRIPTION 

blur computes a new value for each pixel by averaging it with its height*width neighbors. The box filter is 
a height-by-width-sized kernel containing all ones. It makes a horizontal pass of the framebuffer followed 
by a vertical pass. The box filter is truncated at the edges of the framebuffer. If the filter width is not 
given, it is assumed to be equal to the height. (The default is 11.) 

Options: 

-ch Allows channel selection. For example, -ch rg indicates that only the red and green channels are 
to be filtered. By default, all four channels are blurred. 

-src xmin xmax ymin ymax 

See intro{ 1). Only the pixels within the window are blurred; the box filter is truncated at the win¬ 
dow edges. 

-dst xmin xmax ymin ymax 
See introil). 

-y Don’t do vertical pass. 

-x Don’t do horizontal pass. 

-h Set high pass. 

-b weight 

Set weight of blurred image fbname for PirlBoxFilter(3 H). 

-c weight 

Set weight of center pixel. 

-n count 

Set number of times. 

-srcfb fbname 

See intro{ 1). 

-dstfb fbname 

See intro( 1). 

DIAGNOSTICS 

Height and width should both be odd numbers. If not, they are made odd by adding one and a message is 
printed. If height and width exceed the framebuffer (or window) dimensions, a modulus is applied and a 
message is printed. 

FILES 

/usr/pixar/host/bin/blur 
SEE ALSO 

PirlBoxFilter(3H), fbdefs(7) 
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NAME 

cbars - video colorbar generator 

SYNOPSIS 

cbars [-c] [—f] [—r] 

DESCRIPTION 

cbars generates colorbars in a Pixar framebuffer for video test and calibration. It generates colored bars at 
75% full saturation, a white bar at 75% of full white, and a black bar at 0% of full white. The default pat¬ 
tern has eight bars in the upper three-fourths of the window. The pluge pattern is drawn in the bottom 
one-fourth of the screen. This pattern contains a 0% black (NTSC encoder jacks this up to 7.5%), a full 
100% white, and an alternating series of blacks: 0%, 2.5%, 0%. It is used to adjust the brightness of a 
monitor. The brightness control is turned until the 2.5% bar is just visible. (The 2.5% bar corresponds to 
the 10% bar of the standard pluge pattern.) The colormap is set by cbars to a gamma of 2.3. 

The following options, which alter the pattern in the lower one-fourth of the screen, are available: 

-c Draw the CBS standard colorbars in which the bottom one-fourth contains the eight bars in 
reverse order with every other one set to black. The resulting colorbars possess the following 
feature: When the red and green guns are turned off, the pattern becomes alternating blue and 
black bars with perhaps a slight discontinuity in the blue bars at the one-fourth screen position. 
By adjusting the “hue” and “chroma” (or “color”) knobs on an NTSC monitor showing this 
pattern, these discontinuities can be made to disappear. In this state, the NTSC monitor is 
correctly color adjusted. 

-f Draw full length bars. The bottom one-fourth is identical horizontally to the upper three-fourths. 

-r Draw reverse bars at the bottom. This is different from the default pattern in that every other bar 
is not set to black. 

SEE ALSO 

PirlCbars(3H),fbdefs(7) 

BUGS 

Is missing the +Q and -I bars of some standard colorbar generators. Is missing the darkest pluge bars of 
some standard colorbar generators. Uses 64-pixel bars for even subdivision of 512 instead of the 512/7 and 
512/12 width bars of some standard colorbar generators. 
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NAME 

cha - perform linear arithmetic on framebuffer channels 

SYNOPSIS 

cha [ 5 ] [ -r rr [rg [rb [ra [>£]]]] ] 

[ ~g gr [gg [gb [ga [^]]]] ] 

[ -b br [bg [bb [ba [, bk ]]]] ] 

[ -a ar [ag [ab [aa [a£]]]] ] 

DESCRIPTION 

cha performs a linear transformation on the pixels of a framebuffer by treating the R, G, B and A pixel 
values of each input pixel as the vector [ R G B A 1 ] and post-multiplying this vector by a 4x5 matrix. 
This matrix is specified on the command line as follows: if the S argument is given, the matrix is 
[50 00 
0 5 0 0 
0 0 5 0 
0 0 0 5 
0 0 0 0 ] 

If the -r, -g, -b or -a flags are given, their arguments appear in the matrix as 
[rr gr br ar 
rg gg bg ag 
rb gb bb ab 
ra ga ba aa 
rk gk bk ak\ 

For example, if R, G, B, and A represent the original red, green, blue, and alpha channel values, and if R’ 
represents the new red channel value, then cha computes R’ - rr* R + rg* G + rb* B + ra* A + rk, and simi¬ 
larly for the other channels, if desired, with coefficients specified as floating point numbers. Note that 
channel values are NOT clamped to the range [0,1.0E]. 

If any of the arguments to these flags but the last are omitted, they default to the last value given. Thus, 

-r rr rg 

generates the column 
[ rr 

rg 
rg 
rg 
0 ] 

If both the 5 and flag arguments are given, the scale factor 5 is applied to the diagonal of the matrix, effec¬ 
tively scaling the input vector before the matrix is applied. 

-srcfb fbname 

See intro(l). 

-dstfb fbname 

See intro{\). 

-src xmin xmax ymin ymax 
See intro( 1). 

—dst xmin xmax ymin ymax 
See introil). 

SEE ALSO 

PirlCha(3H) 


Release 1.2 


November 19,1986 


1 



CLAMP (1) 


Pixar Programmer’s Manual 


CLAMP(l) 


NAME 

clamp - clamp the contents of a framebuffer to [0..2048] 

SYNOPSIS 

clamp [options] 

DESCRIPTION 

clamp sets any pixels greater than 1.0E(2048) to 1.0E, and any pixels less than 0.0E to (X 
Options: 

-srcfb fbname 

See intro( 1). 

-dstfb fbname 

See intro( 1). 

-src xmin xmax ymin ymax 
See intro(\). 

-dst xmin xmax ymin ymax 
See intro{\). 

-ch selectchan 

See intro( 1). Use specified channels only (e.g., -ch rgb, -ch a, -ch AR). 

FILES 

/usr/pixar/host/bin/clamp 
SEE ALSO 

PirlClamp(3H), PWClamp(3C), SSClamp(3Q 
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NAME 

clr - framebuffer clear 

SYNOPSIS 

clr [red [green blue [alpha]]} [options ] 

DESCRIPTION 

clr clears a Pixar framebuffer to a color, each of whose components are specified (red, blue, green, alpha ) 
as an integer in the range [0, 2048]. No argument implies a clear to (0, 0, 0, 0). One argument implies a 
clear to (red, red, red, red). Three arguments implies a clear to (red, green, blue, 2048). Four arguments 
implies a clear to (red, green, blue, alpha). 

Options: 

-w xmin xmax ymin ymax 
See intro( 1). 

-n Clear the complement of any specified window. 

-row y [xmin xmax] 

-col x [ymin ymax] 

Special cases of the -w option for clearing a given row or column or, optionally, a subset of the 
given row or column. 

-ch selectchan 

See intro( 1). Use specified channels only (e.g., -ch rgb, -ch a, -ch AR). 

-fb fbname 

See intro( 1). 

FILES 

/usr/pixar/host/bin/clr 

SEE ALSO 

PirlClear(3H) 

DIAGNOSTICS 

clr will complain about invalid argument values and invalid window descriptions. 
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NAME 

conv - convolve a framebuffer image with a 3x3 filter 

SYNOPSIS 

conv [ options ] 

DESCRIPTION 

conv convolves a frame buffer image with a 3x3 filter. 

Options: 

-k kOO kOl kOl klO kll kl2 k20 k21 k22 

specifies the values of each entry in the kernel. The first value is the left-most entry in the upper¬ 
most row. Subsequent entries complete that row and then move to the next row. 

-laplace 

Use a Laplacian kernel. This is equivalent to “~k 0-10-14 -10-1 0”. 

-n normalize the kernel so the sum of all the weights add up to 1. 

-s scale multiplies each element of the kernel by scale. 

-srcfb fbname 

See intro(l). 

-dstfb fbname 

See intro(\). 

-src xmin xmax ymin ymax 
See intro( 1). 

-dst xmin xmax ymin ymax 
See intro( 1). 

-ch selectchan 

See intro( 1). 

FILES 

/usr/pixar/host/bin/conv 

SEE ALSO 

PirlConvolve3x3(3H) 
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NAME 

copy - copy utility for portions of the framebuffer 

SYNOPSIS 

copy [ options ] 

DESCRIPTION 

copy copies a source window on the framebuffer to a destination window on the framebuffer. The source 
window is copied to all the destination windows, and several destination windows may be specified on the 
command line. 

copy also supports multiple destination logical framebuffers. If more than one destination framebuffer is 
specified (with the -dstfl) command), then the source framebuffer is copied to each of the destination 
framebuffers. Naming the framebuffers via LFBDEFS makes it easier to maintain multiple images on the 
same framebuffer. 

If several destination framebuffers and windows are given, each window is defined relative to the 
corresponding framebuffer definition. If only one destination framebuffer is given, and multiple destina¬ 
tion windows, each window is defined relative to that framebuffer. Similarly, if only one destination win¬ 
dow is given, and multiple destination framebuffers, this window is applied for each framebuffer definition 
during the copy. 

If the destinations pixel window(s) are smaller than the source pixel window then the pixels are clipped to 
the destination pixel windows. 

Options: 

-swap Swap the specified windows instead of just copying. 

-src xmin xmax ymin ymax See intro(l). 

-dst xmin xmax ymin ymax See intro(l). 

-srcfb fbname See intro(l). 

-dstfb fbname See intro( 1). 

-ch selectchan See intro( 1). 

EXAMPLES 

copy -src 0 255 0 255 -dst 256 511 256 511 

This copies the 256x256 pixel window at the origin of the framebuffer into the 256x256 pixel rec¬ 
tangle at (256,256). 

copy -srcfb qO -dstfb ql 

This copies the pixel window defined by the fbdef qO into the pixel window defined byfbdefql. 
copy -srcfb ql -src 0 49 0 19 -dst 100 149 0 19 

This copies the 50x10 pixel window relative to fbdef ql, into a 50x10 pixel window, relative to 
the default fbdef read from the FBDEFS environment variable. (See intro( 1) for a discussion of 
default settings of frame buffers.) 

copy -srcfb qO -dstfb ql -swap 

This swaps the pixel window defined by the fbdef qO and the pixel window defined byfbdefql. 

FILES 

/usr/pixar/host/bin/copy 
SEE ALSO 

PirlCopy(3H), fbdefs(7) 
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NAME 

crc - compute a Cyclic Redundency Check (CRC) on a framebuffer 

SYNOPSIS 

crc 

DESCRIPTION 

crc computes a CCITT standard CRC value for a framebuffer window. The CRC values for each channel 
are printed on stdout. 

Options: 

-fb fbname 

See intro( 1). 

-w xmin xmax ymin ymax 
See intro( 1). 

FILES 

/usr/pixar/host/src/bin/crc.c 

/usr/pixar/host/src/lib/libpirl/crc.c 

SEE ALSO 

Chad(3H), PirlCrc(3H) 

SSCrc(3C), PWCrc(3H) 

DIAGNOSTICS 

none 

BUGS 
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NAME 

gamma - set gamma-corrected colormap 

SYNOPSIS 

gamma [exponent] 

DESCRIPTION 

gamma assumes that a video monitor’s nonlinearities may be approximated by an exponential curve with 
an exponent traditionally called “gamma”. With no exponent argument, gamma sets the colormap to com¬ 
pensate for a gamma of 2.3. 

The program gamma is actually a shell script containing the following command: 
video -gamma $* 


FILES 

/usr/pixar/host/bin/gamma 

/usr/piar/host/bin/video 

SEE ALSO 

video(l) 


Release 1.2 


November 13,1986 


1 



GT (1) 


Pixar Programmer’s Manual 


GT (1) 


NAME 

gt - get a frame buffer image from a picture file 

SYNOPSIS 

gt [ options ] file... 

DESCRIPTION 

gt brings picture(s) from “tile-based” picture file(s) into a frame buffer. The picture file must conform to 
Pixar’s standards for tile-based picture files (see “The Format of Stored Pictures,” in the Pixar Program¬ 
mers’ Manual). The PIXPATH of the environment is used to find the picture(s). Each picture header is 
read to determine the picture size, tile size, and component information. 

Eventually, only those components in the stored picture will be written into the frame buffer. With the 
current frame buffer interface however, selective channel writing can be done only with a slow read- 
modify-write sequence. Currently, then, missing RGB channels are zero by default and a missing alpha 
channel is unity. A red-channel-only picture is now written as (red, zero, zero, unity). The -ch flag should 
be used to assure the selective channel writing. 

When matting is requested, the target frame buffer is assumed to be matted to black. The user should over¬ 
ride this default when the alpha channel of the target image is unassociated with the RGB channels. 

Options: 

-fb fbname 

See intro( 1). 

-o x y causes the picture to be offset as it is decoded. 

-w xmin xmax ymin ymax 
See introifi). 

-t n specifies that only tile number n be read into the frame buffer. 

-1 print the label stored with the picture. 

-clr clears the frame buffer between images. 

-nc don’t display cursor while getting the picture 

-v (verbose) elicits typeout of the frame buffer and recovered file name. 

-ch selectchan 

See intro{ 1). 

-host force host to decode picture. 

FILES 

/usr/pixar/host/bin/gt 
SEE ALSO 

sv(l), gtinfo(l), PicCreat(3H), PicRead(3H), PicClose(3H), fbdefs(7) 

DIAGNOSTICS 

gt will die if it cannot open the file or the frame buffer. 
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NAME 

gtinfo - type out picture file information 

SYNOPSIS 

gtinfo file 

DESCRIPTION 

gtinfo gives details of a “tile-based” picture file. Running the command gtinfo /usr/pixarldemo/pix/1984 
should print something like the following: 

/usr/pixar/demo/pix/1984: 

[no label] 


picture size : 

1024 

768 

tile size : 

1024 

768 

picture offset : 

0 

0 

1 tile in 8192 byte blocks. 

8 encoded bits per channel: 

RGBA 

matted to black 

Tile status : 

tile 0 

complete 


The PIXPATH of the environment is used to find the picture. The picture header is read to determine the 
picture size, tile size, and component information. 

FILES 

/usr/pixar/host/bin/gtinfo 
SEE ALSO 

gt(l), sv(l), PicCreat(3H), PicRead(3H), PicClose(3H) 


Release 1.2 


November 21,1986 


1 




GUIDE (1) 


Pixar Programmer’s Manual 


GUIDE (1) 


NAME 

guide - display fieldguide in framebuffer 

SYNOPSIS 

guide [ -n ] [ -c [ red [ green [ blue [ alpha ]]]]] 

DESCRIPTION 

guide displays a conventional field-guide in a framebuffer by complementing the high bit of the green 
channel. Upon completion, the program waits for a carriage return for recomplementing the framebuffer, 
(thus resetting it to its original contents). 

Options: 

-n Overrides the wait for a carriage return, forcing an exit after the first complement is performed. 

-c Writes the fieldguide permanently into a framebuffer using the specified color. It uses the conven¬ 
tional color specification similar to clr( 1), except that component values are clamped as in 
clamp( 1). 

-fb fbname 

See intro( 1). 

FILES 

/usr/pixar/host/bin/guide 
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NAME 

hg - Take the histogram of a picture 

SYNOPSIS 

hg [ options ] 

DESCRIPTION 

hg generates a histogram of the pixels in the frame buffer. It tallies the number of pixels at each intensity 
level and prints out the minimum and maximum values found for each color. 

Options: 

-fb Ifbdef 

use logical frame buffer. 

-v verbose mode. Prints out the number of pixels found for each of 256 intensities. 

-w xmin xmax ymin ymax 

limit the histogram to the specified window. 

-scale produces a form compatible with scale(\). 
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NAME 

loop - framebuffer animation tool 

SYNOPSIS 

loop [options] 

DESCRIPTION 

loop is a framebuffer animation tool. It allows the user to view a series of stored rectangular framebuffei 
images in sequence, simulating animation. Images are stored in consecutive order within the framebuffer 
row by row. The number of images in a single row should be the maximum number that will fit in the width 
of the framebuffer. Monochromatic images may be viewed using the bw option. When this option is used, 
four sequential images are stored in the red, green, blue, and alpha channels of each image rectangle. The 
video display freezes on each frame for the specified amount of time (see kbd option to modify the numbei 
of frames/sec displayed), and then moves to the next frame. 

The program can be controlled either via the mouse buttons or the keyboard (see kbd option below). The 
mouse should only be used outside of the window system to avoid any side-effects. If the keyboard option 
is used, keys *1 *,*2\ and ’3’ correspond to the Left, Middle, and Right buttons on the mouse. The key ’q’ 
corresponds to simultaneously pressing the Left and Right mouse buttons which exits the program. 

The Middle button toggles between single step and continuous modes. 

Single Step: 

Right: forward one frame 
Left: backward one frame 

Continuous: 

Right: changes direction to forward, successive hits cycle speed 
Left: changes direction to backward, successive hits cycle speed 

The following options are available, with numbers in brackets representing the default values (used if nc 
argument is given). 


-blank n 

Blank frames at end of loop [0] 

-bw 

Run in black and white (single channel images) 

-cont 

Start off in continuous mode 

-count n 

Use count instead of mouse 

-fsize x y 

framebuffer memory dimensions xy [1024 4096] 

-file commands 

read commands from file 

-frames n 

Number of frames (max that will fit) 

-help 

Print mouse instructions 

-kbd 

Use keyboard instead of mouse (will give directions) 

-oxy 

starting frame offset xy [0 0] (pixel dimensions) 

-rock 

Rock loop back and forth 

-s xy 

frame sizexy 

-speeds SI S2 S3 S4 

Set loop speeds in frac. of secs [1/24 1/12 1/6 1/3] 

-start n 

Frame to start on 

-video 

use video speeds [1/30 1/15 1/7.5 1/3.25] 

-vsize x y 

video dimensions x y 

-zoom factor 

zoom factor (defaults to fill screen if not specified) 


EXAMPLES 

To rock back and forth across a 16 frame film loop of 256x256 monochrome images, the following com 
mand would be issued: loop -bw -kbd -rock -frames 16 -s 256 256 

BUGS 

Frame size -fsize should be settable with -fb fbname. 
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NAME 

merge - merge two frame buffer windows onto a third 

SYNOPSIS 

merge \fgfbname ] operator [bgfbname ] [to [dstfbname]] 

[-If coeffspec] 

[-lb coeffspec ] 

[-fpt xmin ymin] 

[-bpt xmin ymin] 

[-dpt xmin ymin] 

[—s width height] 

DESCRIPTION 

Pixels from foreground frame buffer fgfbname are merged into the pixels of the (possibly different) back¬ 
ground frame buffer bgfbname , with output to the (possibly different) frame buffer dstfbname. 

fgfbname, bgfbname and dstfbname are frame buffers (discussed in Ifbdefstfl)), specified either as a quoted 
delimited string or as the name of a frame buffer in the LFBDEFS environment variable. Windowing 
offsets in a frame buffer are given with the -fpt, -bpt and -dpt arguments. The size of the merge window 
is clipped to the intersection of all windows and one of size (width, height ). 

An operator is one of the operators listed below, as described in Compositing Digital Images, included in 
the Pixar Programmer’s Manual. Note that the operators and to are keywords to merge, so that it is an 
error for any Ifbdef to have the same name as an operator (or to). 

clear Clear the destination window 

copy Copy the foreground 

noop Copy the background 

over (‘ * merge foreground over background’ ’) 

Copy both foreground and background, copying foreground where they intersect 
under (“merge foreground under background’’) 

Copy both foreground and background, copying background where they intersect, 
out (‘ ‘use foreground held out by background’ ’) 

Copy those parts of the foreground lying outside the background 
in (“use background held out by foreground’ ’) 

Copy those parts of the background which intersect the foreground 
above (“copy foreground above background”) 

Like in, but also copies background pixels lying outside the foreground 
below (“copy background above foreground”) Opposite of above 
xor (‘‘foreground or background, but not both’ ’) 

Copies foreground and background, except where they intersect 
plus (“add pixels”) Sums the pixel values, 

plusin (“sum pixels in intersection”) 

Takes the sum of the two images, writing the result where the background appears, 
plusbelow (“sum pixels above background”) 

Mix pixels where foreground and background intersect; copy background elsewhere, 
plusabove (“sum pixels above foreground’ ’) 

Mix pixels where foreground and background intersect; copy foreground elsewhere. 

A coeffspec gives a weighting coefficient for the channels of the foreground or background. It is desig¬ 
nated by either 1, 2, or 4 floating point numbers within slashes. The coeffspec / .7 / is equivalent to / .7 .7 
.7 .7 /, which effects a dissolve to 70% of each channel. The coeffspec / .4 .5 .6 / is equivalent to / .4 .5 .6 
1. /, which darkens the pixels to 40% of red, 50% of green, 60% of blue. 

SEE ALSO 

fbdefs(7), PirlMerge(3H) 
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NAME 

perm - permutations of the frame buffer. 

SYNOPSIS 

perm [ options ] 

DESCRIPTION 

perm has several options for permuting the order or rows and columns of a Pixar frame buffer, and some 
simple image processing (clamping, inversion, ax+b) options. All perm routines operate on a single pixe] 
window. 

Options: 

-clamp Clamp a pixel’s components within unit range (0 to 2048). 

-not Subtract pixel components from unit range (2048 - value). 

-axb A B 

Compute Ax+B for each component x (2048 equals a coefficient of 1.0) 

-u[p] n Circular shift up n lines. 

-d[o\vn] n 

Circular shift down n lines. 

—l[eft] n 

Circular shift left n columns. 

-r[ight] n 

Circular shift right n columns. 

-nofill Use regular shift instead of circular shift The shifted window is clipped to the original window 
and the exposed area remains the same. 

-rc Reverse the columns. Exchange the left and right. 

-rr Reverse the rows. Exchange the top and bottom. 

-shuffle shuffle chan 

Shuffle rgba (e.g., -shuffle rgab, -shuffle ggrr). Each component from the new pixel is copied 
from the specified source component. (See intro( 1).) 

-trans Transpose the framebuffer. That is, exchange the lower left with the upper right. This optior 
works on the largest square in the given window, the one with the same upper left comer as the 
given window. 

-ch selectchan 

See intro{\). 

-src xmin xmaxymin ymax See introil). 

-dst xmin xmax ymin ymax See intro( 1). 

-srcfb fbname See intro( 1). 

-dstfb fbname See intro{ 1). 

FILES 

/usr/pixar/host/bin/perm 

SEE ALSO 

fbdefs(7) 

BUGS 

Only one permutation allowed per invocation. Additional specifications overwrite the previous options. 
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NAME 

pixinit - initialize the pixar and the configuration tables 

SYNOPSIS 

pixinit 

DESCRIPTION 

pixinit runs a shell script to initialize the pixar and the configuration tables, pixinit has the same effect as 
issuing the following commands to each appropriate piece of installed hardware. 

mctrl init mips 5555 
video -init -gamma 
dumi iena 
chconfig -a -k 32 

All installed hardware is initialized. Any loaded Chap programs and data are lost. The contents of the 
framebuffer are left intact 

FILES 

/usr/pixar/host/bin/pixinit /usr/pixar/host/bin/mctrl /usr/pixar/host/bin/video /usr/pixar/host/bin/dumi 
SEE ALSO 

mctrl(4), video(l), dumi(l), chconfig(l) 
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NAME 

ramp - ramp framebuffer window horizontally or vertically 

SYNOPSIS 

ramp [—ct [c]] [-cb [c]] [-cl [c]] [-cr [c]] [-ul [c]] [-ur [c]] [—dl [c]] [-dr [c]] 

[fB-w xmin xmax ymin ymax] [-ch selectchan ] [—fb fbname ] 

DESCRIPTION 

ramp causes a ramp of colors to be placed in the specified framebuffer window (the entire visible frame- 
buffer by default) and in the specified channels (all of them by default). The ramps are automatically dith¬ 
ered with a 3x3 ordered dither matrix. Several types of ramp are supported. 

-ul, ur, dl, dr color 

The most general case is the bilinear interpolation of the colors at the four comers of the given 
window, where the up left, up right, down left, and down right colors are specified by these four 
options. (“Up” and “down” refer to the visual directions.) 

-ct, cb, cl, cr color 

set color of top, bottom, left, and right respectively. 

-w xmin xmax ymin ymax 
See introil). 

-ch selectchan 

See intro{ 1). 

-fb fbname 

See intro{\). 

In all cases, the optional argument c is short for the usual color specification [red [green blue [alpha]]], 
where the color (0, 0, 0, 0) is assumed if the argument is not given, the color (red, red, red, red) is assumed 
if only red is specified, and the color (red, green, blue, 0) is assumed if alpha is not specified. Alterna¬ 
tively, a top-to-bottom ramp may be specified with the ct and cb options for the top and bottom colors, 
respectively. Similarly, a left-to-right ramp may be specified with the cl and cr options. 

Three point ramps are possible if the specifications are consistent For example, the ul and ur options may 
be used with the cb option rather than with the dl and dr options set to the same color. 

FILES 

/usr/pixar/host/bin/ramp 

SEE ALSO 

fbdefs(7) 
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NAME 

resize - resize utility for portions of the framebuffer 

SYNOPSIS 

resize [options] 

DESCRIPTION 

resize resizes a source window on the framebuffer to a destination window on the framebuffer. The source 
window is resized into all the destination windows, and several destination windows may be specified on 
the command line. 

resize also supports multiple destinaiton logical framebuffers. If more than one destination framebuffer is 
specified (with the -dstfb command), then the source framebuffer is copied to each of the destination 
framebuffers. Naming the logical framebuffers via LFBDEFS makes it easier to maintain multiple images 
on the same physical framebuffer. 

If several destination framebuffers and windows are given, each window is relative to the corresponding 
framebuffer definition. If only one destination framebuffer is given, and multiple windows, each window 
is defined relative to that framebuffer. Similarly, if only one destination window is given, and multiple 
destination framebuffers, this window is applied for each framebuffer definition during the resize. 

Options: 

-ext x y Specify and horizontal and vertical filter extent size (default 4 4). Possible filter extents are two 
and four. The four pixel filter (cubic) gives the best possible resizing, as opposed to the two pixel 
filter (linear). 

-src xmin xmax ymin ymax 
See intro{ 1). 

-dst xmin xmax ymin ymax 
See intro( 1). 

-ch selectchan 

See intro( 1). 


See intro{ 1). 

EXAMPLES 

resize -src 0 255 0 255 -dst 256 300 256 400 

This resizes the 256x256 pixels square at the origin of the framebuffer into at 45x145 pixel rectan¬ 
gle at (256,256), using the default 4x4 cubic filter. 

resize -srcfb qO -dstfb ql -ext 2 2 

This resizes the pixel window defined by the fbdef qO into the pixel window defined by fbdef ql, 
using the 2x2 linear filter. 

resize -srcfb ql -src 0 49 0 19 -dst 60 200 60 200 

This resizes the 50x10 pixel window relative to fbdef ql, into a 201x201 pixel window, relative to 
the default fbdef read from the FBDEFS environment variable, using the default 4x4 cubic filter. 
(See introiX) for a discussion of default settings of frame buffers.) 

FILES 

/usr/pixar/host/bin/resize 


r-es.fcc —src. 0 0 nkl -dMs f 0 SZ0 
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NAME 

rotate - rotate a framebuffer region 

SYNOPSIS 

rotate [options] 

DESCRIPTION 

rotate rotates, scales,and translates a source window about a center point on the framebuffer to a destina¬ 
tion window on the framebuffer. The transformation is performed using a two-pass (horizontal and verti¬ 
cal) resampling algorithm. 

Source and destination windows can be specifed for each pass of the resampling algorithm. The source 
and destination windows for each pass cannot partially overlap. Arguments src and srcfb define the 
transformation source window. Arguments tmp and tmpfb define the destination window for the first 
(intermediate) pass and the source for the second pass, dst and dstfb define the the destination for the 
second (final) pass. If only a src argument is given, the transformation is done in place. If a tmp argument 
is not specified, the dst argument is used as the destination for both passes; however, if the dst window is 
smaller than the src window, a tmp window of the size of the src window must be specified. 

Options: 

-src xmin xmax ymin ymax 

Specify source transformation window 

-tmp xmin xmax ymin ymax 

Specify intermediate transformation window 

-dst xmin xmax ymin ymax 

Specify destination transformation window 

-srcfb Ifbdef 

Specify source framebuffer (see FBDEFS(7)) 

-tmpfb Ifbdef 

Specify intermediate framebuffer 
-dstfb Ifbdef 

Specify destination framebuffer 

-ext size 

Specify the filter extent size [default 4], Possible filter extents are two and four. The four pixel 
filter (cubic) gives the best possible resizing, as opposed to the two pixel filter (linear). 

-a angle 

Specify the angle (in degrees) to rotate the picture by [default 0.0]. 

-s sx sy Specify the scale factors for the picture [default 1.0,1.0]. 

-ccxcy 

Specify the center point of the image for rotation [default center of picture]. 

-noclr Don’t clear the area underneath the destination window (this is faster) 

-ch selectchan 

Use specified channels only (e.g., -ch rgb, -ch a, -ch AR). 

FILES 

/usr/pixar/host/src/bin/rotate.c 

/usr/pixar/host/src/lib/libpirl/affine.c 

SEE ALSO 

PirlRotate(3h), PirlAffine(3h), PirlShear(3h), PWShear(3c), FBDEFS(7) 
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NAME 

scale - scale framebuffer RGB A intensities 

SYNOPSIS 

scale [-hi [color]] [-lo [color]] [-HI [color]] [-LO [color]] [-zhi [color]] [-zlo [color]] 

[-src xmin xmax ymin ymax] [-dst xmin xmax ymin ymax] [-ch selectchan] /-srcfb fbname] [-dstfb 
fbname] 

DESCRIPTION 

scale remaps the RGBA channels of a framebuffer by linearly mapping the domain [lo, hi] onto the range 
[LO, HI], channel by channel. All colors outside the range [zlo, zhi], again on a channel by channel basis, 
are ignored. 

In all cases, the optional argument color is short for the usual color specification [red [green blue [alpha]]], 
where the color (0, 0, 0, 0) is assumed if the argument is not given, the color (red, red, red, red) is assumed 
if only red is specified, and the color (red, green, blue, 0) is assumed if alpha is not specified. 

Options: 

-hi [red[green[blue[alpha]]]] 

Scale given color to HI [default = (0,0,0,0)]. 

-lo [red[green[blue[alpha]]]] 

Scale given color to LO [default = (0,0,0,0)]. 

-HI [red[green[blue[alpha]]]] 

Set HI color [default = white = (2048,2048,2048,2048)]. 

-LO [red[green[blue[alpha]]]] 

Set LO color [default = clear = (0,0,0,0)]. 

-zhi [red[green[blue[alpha]]]] 

Set zhi color [default = white = (2048,2048,2048,2048)]. 

-zlo [red[green[blue[alpha]]]] 

Set zlo color [default = clear = (0,0,0,0)]. No intensities outside range [zlo, zhi] are changed. 

-srcfb fbname 

See intro( 1). 

-dstfb fbname 

See introil). 

-src xmin xmax ymin ymax 
See intro( 1). 

-dst xmin xmax ymin ymax 
See intro{ 1). 

-ch selectchan 

See intro( 1). 

FILES 

/usr/pixar/host/bin/scale 

SEE ALSO 

fbdefs(7), clamp(l) 
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NAME 

see - display an image from raster files of various formats 

SYNOPSIS 

see [ options ] file... 

DESCRIPTION 

see displays a raster image file that is stored in one of a variety of available formats. This program is ideal 
for displaying pictures that were not saved using the sv command. 

Both 8 bit-per-channel and 16 bit-per-channel images can be displayed. With 8 bit-per-channel images, the 
option is available (with the -sh flag), to multiply each channel value. With 16 bit-per-channel images, it 
may be necessary to swap the bytes in each 16 bit channel word (using the -swap flag), depending on the 
machine used to create the image. 

see will also display RGB channel images by filling in the value zero for the alpha channels. 

Options: 

-seek Skip the first n bytes of the file. (Note: sv pads each image file with an 8192 byte header.) 

-8bw 8 bit black and white image file. 

-16bw 16 bit black and white image file. 

-8rgb 8 bit RGB image file. 

-16rgb 16 bit RGB image file. 

-8rgba 8 bit RGB A image file. 

-16rgba 

16 bit RGB A image file. 

-sh Multiply each channel value by 8. 

-swap Swap the bytes in each 16 bit channel word. 

-fb fbname 

See intro{ 1). 

-w xmin xmax ymin ymax 
See intro{ 1). 

-ch selectchan 

See introil). 

FILES 

/usr/pixar/host/bin/see 
SEE ALSO 

sv(l), gt(l), gtinfo(l), PirlGetRaster(3H), fbdefs(7) 
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NAME 

sv - save frame buffer into picture file 

SYNOPSIS 

sv file [ options ] 

DESCRIPTION 

sv saves the picture contained in a frame buffer as a “tile-based” picture file on disk with mode 0444. If 
file exists, overwrite permission is requested unless the force option is selected. Files saved with alpha 
components are flagged as “matted-to-black”, unless this is explicitly overridden. The created file con¬ 
forms to Pixar’s standards for tile-based picture files (see “The Format of Stored Pictures” in the Pixar 
Programmer’s Manual) and can be retrieved with the program gt. 

Options: 

-fb fbname 

See intro( 1). 

-ch selectchan 

See intro( 1). 

-tu states that the picture is not “matted-to-black”, that the alpha channel is unassociated with the 
RGB. 

-mode Oddd 

requests that the file be saved with Oddd protection. 

-f forces the removal of any existing file. 

-v (verbose) elicits typeout of the created file name. 

-t width height 

asks that a specific tile size be used. The default is the size of the picture. 

-w xmin xmax ymin ymax 

See intro{\). The default is the size of the frame buffer. The tile size is always limited to be no 
bigger than the picture size in either dimension. 

-1 label provides a label to be stored in the picture header. 

-dump indicates that pixel information should be stored dumped rather than run-length encoded (the 
default). 

-12bit indicates that pixel information should be stored with 12 bits per channel. 

-cur string 

set cursor string. 

-nc don’t display the cursor while saving picture (the default is to display the cursor). 

-host force host to do the encoding. Normally, the Pixar does the encoding. 

FILES 

/usr/pixar/host/bin/sv 
SEE ALSO 

gt(l), gtinfo(l), PicCreat(3H), PicRead(3H), PicClose(3H) 

DIAGNOSTICS 

sv will die if it cannot create the file or open the frame buffer. A PicCreat error results if the tilesize is <= 
0 in either dimension or the picture size is <= 0 in either dimension. 
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NAME 

tool - framebuffer tool 

SYNOPSIS 

tool [options] 

DESCRIPTION 

tool is a framebuffer diagnostic tool. It provides a crosshair cursor that may be moved around the frame- 
buffer display under keyboard control, where u=up, d=down, r=right, l=left. The contents of the pixel at 
the crosshair may be read or written. The display may be zoomed up (centered on the current crosshair 
location). Following is a complete set of one-key commands available: 


и, d,r,l: 

U,DJRJL: 

+,<retum>,<down arrow>: 
-,',<up arrow>: 
<space>,<right arrow>: 
<backspace>,cleft arrow>: 
<tab>: 

0,1,23,4,5,6,7,8: 

9: 

C: 

h,<home>: 

H: 

c: 

к, K: 
m: 

M: 

o: 

p: 

q: 

s: 

S: 

v: 

I; 

? : 


up, down, right, or left one pixel 

up, down, right, or left N pixels [default=32] 

alternatives for d 

alternatives for u 

alternatives for r 

alternatives for 1 

alternative R 

set hardware zoom to this value 

demagnify without centering 

exit program without removing crosshair 

move to screen center (home) 

hsv switch 

colormap switch 

crosshair display switch 

move to new location (’.’ means current value) 

exit program without demagnifying 

move to screen upper left (origin) 

print pixel value and location 

exit program 

set pixel value 

set large xstep, ystep sizes [default=32 30] 
verbose switch 

escape to Shell for one command 
help 


Options: 


-p x y Prints the RGB A at the specified pixel location. 

-s x y Sets the RGB A at the specified pixel location to the color specified with the -c command (see 
below). 

-c[r[gb[a]]] 

Specify a color for the -s command in the usual way. I.e., no args means color (0, 0, 0, 0); one 
arg means (r, r, r, r); three args (r, g, b, 2048); four args (r, g, b, a). 


-r range 

When (r, g, b, a) or (h, s, v, a) is printed to a terminal, this command causes each element to be 
remapped to [0, range], except for h , which is remapped to [0, 6*range]. Range is 2048 by 
default. 
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-fb fbname 

See introil). 

FILES 

/usr/pixar/host/bin/tool 

BUGS 

Hardware zoom values 9-16 not available. 
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NAME 

video - video board utility 

SYNOPSIS 

video [options] 

DESCRIPTION 

video is a general purpose shell-level interface to the Pixar video board controller. Roughly, this involves 
setting what area of the framebuffer memory is read out, and how it is interpreted. To find out specifically 
what the hardware can do, see the video** routines in libvideo{ 3H). 

Options: 


-file dev-name 
-init 
-base n 
-red 
-green 
-blue 
-rgb 
-alpha 
-blank 
-width n 
-height n 
-twidth n 
-theight n 
-zoom n 
-x n 
-yn 
-start n 

-gamma exponent 

-on 

-off 

-ntsc 

-hidef 

-freq n 

-format n 

-verbose 


video device [/dev/videoO] 

initialize parameters 

set base [10] 

display red 

display green 

display blue 

display red-green-blue 

display alpha 

blank video 

set width 

set height 

set tile width [32] 

set tile height [24] 

set magnification [1] 

set x offset [0] 

set y offset [0] 

set starting tile block 

set color map correction [2.3] 

turn cursor on 

turn cursor off 

set ntsc format 

set high definition format 

set video controller frequency [VFREQ-HIDEF] 

set video controller format [VFORM-HIDEF] 

display current settings 


FILES 

/usr/pixar/host/bin/video 


SEE ALSO 

VideoCmap(3H), VideoCursor(3H), VideoDisplay(3H), VideoFormat(3H), VideoOpen(3H) 

BUGS 

The twidth option doesn’t stick: it has to be reset on each command if the argument is different than 32. 
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NAME 

intro - introduction to Pixar library functions 

DESCRIPTION 

This section describes functions that may be found in various Pixar support libraries. There is a manual 
page for each library, named after the library. For example, libpirl( 3H) gives a summary of each function 
in the Pixar Runtime Library. 

The archive for each library resides in /usr/pixar/host/lib. 

lib pixar .a 

low-level routines comprising the basic host interface with the registers, buses, etc. of the Pixar. 
This library includes the dynamic loader of native Chap routines, routines to manipulate the 
video parameters and colormap, routines for accessing the diagnostic registers, and much more. 
However, there is little here that the end-use programmer should need to know about it; almost 
all the functionality of ’libpixar’ is contained in the three libraries below. 

libchad.a 

a high-level host-interface library for the Pixar in general and the Chap in particular, ’libchad’ 
contains all ’Chad...’ routines, and is required for using ’libpirl* and ’libpicio’. 

libpirl^a library containing many C-callable (’Pirl...’) routines for performing functions on the Chap. 
Typically, ’libpirl’ functions only require descriptions of one or more sections of frame buffer 
memory, and the functions take care of all interface tasks, like manipulating Chad. 

libpicio^ 

library of functions dealing with moving pictures between the frame buffer and external media, 
primarily disk files. 

The libraries above are listed in order of dependence: to use Chad, ’libpixar’ must be included in the list of 
libaries. Thus, if you write a program called ’myprog’, which uses the Pirl package, it should have a com¬ 
mand line that looks something like: 

cc -o myprog myprog.o /usr/pixar/host/lib/libpirl.a /usr/pixar/host/lib/libchad.a\ 
/usr/pixar/host/lib/libpixar.a 

libGja library of general routines. For now, this is simply the resting place for FBGETDEF, the library 
module that standardizes frame buffer conventions. 

SEE ALSO 

intro(3), intro(3C), intro(3H), libpixar(3H), libpirl(3H), libpicio(3H), libchad(3H). 
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NAME 

libchad - Pixar resource-management library 

DESCRIPTION 

Chad is a simplified library for allocating and maintaining dynamic scratchpad and instruction RAM on a 
Chap. Chad mimics conventional dynamic memory allocation with certain functional extensions. Rou¬ 
tines are provided to allocate and deallocate space in a Chap’s instruction space and scratchpad memory, 
adding facilities for allocating tile blocks and pixel windows, loading scratchpad, Sbus registers, the sysbus 
and image memory, and linking and executing microcode. This manual page summarizes the routines 
comprising Chad and discusses their calling conventions. Each routine is detailed in another manual page, 
and there is a tutorial introduction, Programming the Pixar with Chad , which is intended as an introduction 
to the system. 

Chad maintains a separate block-storage environment for each Chap attached to a system. The environ¬ 
ment is entered by ChadBegin( 3H) and exited with ChadEndQH). These functions are detailed in 
ChadBegin( 3H). 

ROUTINES 

Specific resources are allocated by calling ChadAllocQH) and released by ChadFreeQK). All the 
resources of a given class (SPAD, RAM, etc.) may be released by calling ChadResetQK). This action is 
useful in recovering when resources are exhausted, since it releases all resources which were allocated by 
other processes, in effect performing a complete housecleaning. 

The function ChadBackupQH) is used to deallocate all resources younger than its argument This routine 
has a role in error recovery, allowing a user routine to free up all resources used by it and any routines it 
calls. 

A resource that has been deallocated for any reason is specially marked: its ‘addr’ field becomes negative. 
When this occurs, the resource may be reallocated by ChadCheckQH). Each resource structure maintains 
information to reconstruct its space, but naturally, ChadCheckQH) can only reallocate space, not initialize 
it. 

Of die deallocation routines, all but ChadFree( 3H) leave the Chad host structures intact, so that the ‘addr’ 
field may be checked. All of the above allocation and deallocation routines are documented in 
ChadAlloc( 3H). 

Once allocated, data may be written using ChadWriteQH), and read using ChadReadQH). In addition, 
individual pixels may be written to a ChadFrame resource using the macro CHAD_SETPXL and read 
using CHAJ)_GETPXL. All four of these procedures are listed in ChadWriteQH). 

Resources of type RAM (i.e.. Chap functions, listed in section 3C of the Pixar manual pages) may be exe¬ 
cuted with ChadGo{ 3H). Execution proceeds asynchronously, with ChadGoQH) returning before the 
Chap routine completes. The status of execution is checked with ChadCPUBusyQH ), which is non-zero 
as long as a routine is still running. The function ChadWaitCPUQ H) provides a busy wait, which does not 
return until the Chap routine completes. The manual page for these execution routines is ChadGo( 3H). 

All Chad routines return an error code, which is NULL (CHAD__NOERROR) for normal return. Once 
detected, a message explaining the error can be sent to a file with ChadErrReport{ 3H). 

UNIVERSAL TRUTHS 

Since several Chaps may be attached to a host, and since Chad maintains a separate environment for each, 
it is necessary to distinguish among them. This is done, where appropriate, with tokens of type ChapID. 
ChadBeginQH), ChadEndQH), ChadRead( 3H), ChadWriteQH), ChadResetQK), ChadCPUBusy( 3H), 
ChadWaitCPU( 3H) and ChadReset( 3H) all require such a token as their first argument. 

When pixel values are passed to Chad routines, it is in the form of the RGBAPixelType datatype defined in 
<pixeldef.h> 

Most Chad routines take a variable number of arguments, allowing, for example, several allocations to be 
performed with a single function call. The last argument to each of these routines must be the special 
token, NIX. The arguments to ChadAlloc( 3H), ChadRead( 3H), ChadWriteQK) are arranged in groups. 
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called resource specifications. Each specification begins with a type token like SPAD or RAM. This is 
followed by a type-dependent number of arguments laid out in the manual pages. With the exception of 
the FRAME specification to ChadRead( 3H) and ChadWrite(3Yf), the arguments of a specification are fixed 
in number and type. 

All Chad resource types share certain characteristics. First, each has a field, named ’addr’. This field pro¬ 
vides information to Chad, and it is set to an invalid (negative) value when the resource is deallocated. 
Second, each resource has a ‘new’ field which is set non-zero when a resource is first allocated and when¬ 
ever it is reallocated. This allows the user to perform any initialization necessary. Finally, each resource 
retains the parameters to ChadAllocQH) used to allocate it; the function ChadCheck(3H) will recover 
resources up to but not including any initialization by the user. 

The document Programming the Pixar with Chad discusses the principles behind Chad and gives opera¬ 
tional examples. The manual pages listed below give more terse explanations. 

ERRORS 

All Chad routines return an error code, which is NULL (CHADNOERROR) for normal return. Once 
detected, a message explaining the error can be sent to a file with ChadErrReport( 3H). 

LIBRARIES 

/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

ChadBegin(3H), ChadAlloc(3H), ChadWrite(3H), ChadGo(3H), ChadErrReport(3H), ChadFrame(3H) 
intro (1) - list of shell-callable Pixar programs 

intro (3Q - list of libraries of device-resident routines 

intro (3H) - list of libraries of host-resident routines 

LIST OF FUNCTIONS 

Name Appears on Page Description 

CHAD_GETPIXELO ChadFrame(3H) - get a pixel from Pixar image memory 

CHAD_SETPIXELO ChadFrame(3H) - set a pixel in Pixar image memory 

ChadAllocO ChadAlloc(3H) - allocate Chad resources 

ChadBackupO ChadAlloc(3H) - release recently-allocated resources 

ChadBeginO ChadBegin(3H) - enter the Chad environment 

ChadCPUBusyO ChadGo(3H) - is the previous Chap routine still executing? 

ChadCPUWaitO ChadGo(3H) - wait for the last Chap routine to complete 

ChadCheckO ChadAlloc(3H) - confirm the continued existence of Chad resources 

ChadEndO ChadBegin(3H) - leave the Chad environment 

ChadErrReportO ChadErrReport(3H) - explain an error by Chad 

ChadFrameO ChadFrame(3H) - discussion of Chad frames 

ChadFreeO ChadAlloc(3H) - free Chad resources 

ChadGoO ChadGo(3H) - execute a Chap routine 

ChadLibsO ChadAlloc(3H) - include an archive in Chad’s search list 

ChadReadO ChadWrite(3H) - read Chap resources 

ChadResetQ ChadAlloc(3H) - reset a Chap 

ChadWriteO ChadWrite(3H) - write to resources on the Chap 
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NAME 

ChadAllocO, 

ChadFreeO, 

ChadLibsO, 

ChadResetO, 

ChadCheckO, 

ChadBackupO - Chad resource allocation routines 

SYNOPSIS 

# include "/usr/pixar/include/chad.h" 

ChadError ChadAlloc (chapid, 

[SPAD, blockpp, nwords,] 

[RAM, pcpp, sym,] 

[PIXELS, blockpp, npixels,] 

[TB, tbpp, firsttile, tileswide, tileshigh,] 

[PW, pwpp, tbpp, xmin, xmax, ymin, ymax,] 

[FRAME, framepp, tbpp, xmin, xmax, ymin, ymax,] 

NIX) 

ChadSpad *(*blockpp); 

ChadPC *(*pcpp); 

ChadTB *(*tbpp); 

ChadPW *(*pwpp); 

ChadFrame *(*framepp); 
int nwords, npixels, firsttile, tileswide, tileshigh, 
csr, xmin, xmax, ymin, ymax; 
char *sym; 

ChadError ChadFree ([blockp,] [pep,] [tbp,] [pwp,] [framep,] NIX) 
ChadSpad * blockp; 

ChadPC *pcp; 

ChadTB *tbp; 

ChadPW *pwp; 

ChadFrame * framep; 

ChadError ChadLibs (libl,...,libN,NIX) 
char *libl,...,libN; 

ChadError ChadReset (chapid, [RAM,] [SPAD,] [TB,] [PW,] NIX) 

ChapID chapid; 

ChadError ChadCheck (chapid, [blockp,] [pep,] [tbp,] [pwp,] [framep,] NIX) 
ChapID chapid; 

ChadSpad * blockp; 

ChadPC *pcp; 

ChadTB *tbp; 

ChadPW *pwp; 

ChadFrame *framep; 

ChadError ChadBackup(structp); 
union { 

ChadSpad spad; 

ChadPC pc; 

ChadTB tb; 

ChadPW pw; 

ChadFrame frame; 

} *structp; 
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DESCRIPTION 

The routines ChadAlloc and ChadFree manage resources of several types on a Pixar’s Chap processor. 
Several storage requests are combined in a single call using the allocation requests above. A SPAD request 
allocates dynamic space in the Chap’s scratchpad memory. PIXELS requests are similar, but expressed in 
multiples of 4 words. RAM requests invoke the Chap dynamic loader (see chap {A) for more information) 
to load routines into the Chap’s instruction memory, resolving undefined symbols from a list of libraries 
maintained by Chad. This list initially includes libcolor.a, libpG.a, libpip.a, libpm.a, libpt.a and libpx.a in 
‘/usr/pixar/chap/lib’. Other libraries may be prepended to the list by calling ChadLibs, giving as arguments 
a set of full Unix file pathnames denoting the libraries to be used. 

The TB specification requests that a Tile Block be allocated on the Chap. The tile block is a set of tiles of 
image memory, each tile being 32x32 pixels square. The specification gives the first tile, the number of 
tiles required in a row and the number of rows required. 

PW gets a pixel window, a rectangular region of pixels within a tile block. This is specified by giving a 
rectangle expressed in pixels, with pixel (0,0) defined as the upper left comer of the tile block. 

A ChadFrame (specified by FRAME) is similar to a pixel window, but maintains the notion of a current 
pixel which can be used for reading and writing into image memory. It is discussed in ChadFrameQH). 

Several routines for deallocating resources are provided, tailored to different situations. ChadFree is 
unique in that it 1) deallocates only those resources in its argument list, and 2) frees the Chad structure 
associated with the resource, so that the pointers passed to it are no longer valid. 

Of the remaining deallocation routines, ChadReset is the most drastic. Rather than Chad pointers, Cha- 
dReset takes a (possibly empty) set of type tokens, deallocating all resources of those classes. This is use¬ 
ful primarily for correcting storage leaks. If no type tokens appear in the argument list, ChadReset per¬ 
forms a device reset of the Chap, deallocating all the resources of all types on that Chap, and also rendering 
invalid any resources being used by any other process running concurrently on that Chap. Under some cir¬ 
cumstances, this can be considered unfriendly. 

ChadBackup takes a single Chad pointer as it argument. The denoted resource is deallocated, together with 
all resources of any type allocated after it. This action is useful for error recovery, when a function must 
clean up all its resources and those allocated by those functions it calls. 

All Chad resources contain an ‘addr’ field. When a resource is deallocated, this field is set to an invalid 
value, which is less than 0. Thus, the application can always check the continued survival of a resource 
without consulting Chad (It is an error to use a deallocated resource). However, Chads have no access to 
resources in other processes, and so the ‘addr’ field can remain valid even when its resource has disap¬ 
peared (this can only occur if more than one process is using a Chap at a time). A mechanism is thus 
required for confirming that the ‘addr’ field still has meaning. ChadCheck confirms the validity of the 
resources in its argument list; if any have been deallocated, it consults the Chads structure associated with 
the resource and calls ChadAlloc to recover the resource if possible. Naturally, it is unable to reinitialize 
any data which may have been lost with the deallocation. Each structure contains a ‘new’ field, set to non¬ 
zero when the resource is reallocated. 

The document Programming the Pixar with Chad discusses the principles behind Chad and gives opera¬ 
tional examples. The manual pages listed below give more terse explanations, with chadQK) being the 
most complete. 

LIBRARIES 

/usr/pixar/host/libAibchad.a/usr/pixar/host/lib/libpixar.a 

ERRORS 

All Chad routines return an error code, which is NULL (CHAD_NOERROR) for normal return. Once 
detected, a message explaining the error can be sent to a file with ChadErrReportQ H). 

SEE ALSO 

ChadBegin(3H), libchad(3H), ChadWrite(3H), ChadGo(3H), ChadErrReport(3H), ChadFrame(3H) 
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The Chad Tutorial, in The Pixar User's Manual, serves as an introduction to Pixar programming using the 
Chad routines. Also recommended is the Chap Programming Tutorial, in the same source, which 
discusses, indirectly, many of the tasks Chad performs invisibly. 
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NAME 

ChadBegin, 

ChadEnd - Pixar resource-management library 

SYNOPSIS 

# include "/usr/pixar/include/chad.h" 

ChadError ChadBegin(chapid, exclusive) 

ChapID chapid; o ^ o«,e cA CT&jp ^ «>»■»*« **. e 

int exclusive; \ «•*<:. Uvv 4 « <j&« *<-«««&» 

ChadError ChadEnd(chapid) 

ChapID chapid; 

DESCRIPTION 

The Chad runtime library maintains an environment for protecting and managing resources used by a pro¬ 
gram on a Pixar’s Chap processor. The two functions ChadBegin and ChadEnd initialize and terminate 
this environment for a particular Chap. 


The document Programming the Pixar with Chad discusses the principles behind Chad and gives opera¬ 
tional examples. The manual pages listed below give more terse explanations, with chad( 3H) being the 
most complete. 

LIBRARIES 

/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 

ERRORS 

All Chad routines return an error code, which is NULL (CHAD_NOERROR) for normal return. Once 
detected, a message explaining the error can be sent to a file with ChadErrReport{3 H). 

SEE ALSO 

libchad(3H), ChadAlloc(3H), ChadWrite(3H), ChadGo(3H), ChadErrReport(3H), ChadFrame(3H) 

The Chad Tutorial, in The Pixar User’s Manual , serves as an introduction to Pixar programming using the 
Chad routines. Also recommended is the Chap Programming Tutorial, in the same source, which 
discusses, indirectly, many of the tasks Chad performs invisibly. 
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NAME 

ChadErrReport - describe an error by Chad 

SYNOPSIS 

# include "/usr/pixar/include/chad.h" 

ChadError ChadErrReport(fp) 

FILE *fp; 

DESCRIPTION 

When Chad encounters an error, ChadErrReport prints an explanation of the error to the given file. The 
error code is assumed to be the value of ChadLastErr, as set (and returned) by all other Chad routines. 


The document Programming the Pixar with Chad discusses the principles behind Chad and gives opera¬ 
tional examples. The manual pages listed below give more terse explanations, with chad(3H) being the 
most complete. 

LIBRARIES 

/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 

SEE ALSO 

libchad(3H), ChadBegin(3H), ChadAlloc(3H), ChadWrite(3H), ChadGo(3H), ChadFrame(3H) 

The Chad Tutorial, in The Pixar User’s Manual, serves as an introduction to Pixar programming using the 
Chad routines. Also recommended is the Chap Programming Tutorial, in the same source, which 
discusses, indirectly, many of the tasks Chad performs invisibly. 
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NAME 

ChadFrame, 

CHAD_SETPIXEL, 

CHAD_GETPIXEL - access to Pixar image memory 
SYNOPSIS 

# include "/usr/pixar/include/chad.h" 

ChadError ChadAlIoc(chapid, FRAME, framepp, tbpp, xmin, xmax, ymin, ymax, NIX) 

ChapID chapid; 

ChadFrame *(*framepp); 

ChadTB *(*tbpp); 

short xmin, xmax, ymin, ymax; 

ChadError ChadWrite(chapid, 

[ FRAME, framep, FRX, xval, ] 

[ FRAME, framep, FRY, yval, ] 

[ FRAME, framep, FRCSR, csr, ] 

[ FRAME, framep, FRBFR, buffer, xmin, xmax, ymin, ymax, ] 

NIX) 

ChapID chapid; 

ChadFrame *framep; 

RGBAPixelType buffer[][]; 

short xval, yval, csr, xmin, xmax, ymin, ymax; 

ChadError ChadRead(chapid, 

[ FRAME, framep, FRX, xvalp, ] 

[ FRAME, framep, FRY, yvalp, ] 

[ FRAME, framep, FRCSR, csrp, ] 

[ FRAME, framep, FRBFR, buffer, xmin, xmax, ymin, ymax, ] 

NIX) 

ChapID chapid; 

ChadFrame * framep; 

RGBAPixelType bufTer[][]; 

short *xvalp, *yvalp, *csrp, xmin, xmax, ymin, ymax; 

CHAD_SETPIXEL(framep, red, green, blue, alpha) 

ChadFrame *framep; 

unsigned short red, green, blue, alpha; 

CHAD_GETPIXEL(framep, red, green, blue, alpha) 

ChadFrame *framep; 

unsigned short red, green, blue, alpha; 

DESCRIPTION 

The ChadFrame resource manages image memory, allowing programs to directly access pixels of Pixar 
image memory. Associated with the frame is a current pixel, given as an x/y offset within the frame. The 
frame is allocated with the call to ChadAlloc(3K) above, giving a pointer to a frame pointer, a pointer to a 
tile block pointer, and the bounding box of the frame relative to the coordinates of the tile block, where 
(0,0) is the upper left comer. The current pixel is set using ChadWritefSK), which can also be used to 
write a rectangular region of the frame by passing a pointer to sufficient host storage, and the bounding rec¬ 
tangle to be written. For example, 

ChadWrite(CHAPO, FRAME, fp, FRBFR, bufr, 20,25, 30,40, NIX); 

would write 11 lines of 6 pixels each from the buffer bufr. All ChadWrite{ 3H) operations on frames have 
the obvious converse in ChadRead( 3H). 

Individual pixels of the frame can be written using CHAD_GETPIXEL and CHADJSETPIXEL. These 
macros access the current pixel. The address of the current pixel can be set explicitly with ChadWrite(3lf), 
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as above. However, the address can also be set implicitly. The addressing register CSR controls automatic 
incrementation of the current pixel: as desired, the current pixel can be incremented or decremented in X or 
Y, after reads or writes. These actions are controlled by a bit mask obtained by the bitwise or of a set of 
predefined constants. Automatic address modification is enabled by RP_ADDR_MOD. Modification 
upon writing is set with RP_WRITE_ADDR_MOD, otherwise modification occurs upon pixel reads. The 
address is incremented if RP_INC_ADDR_MOD is set, and decremented otherwise. The first coordinate 
incremented or decremented is X if the RP_X_ADDR_MOD is set, otherwise modification occurs first in 
Y. Finally, when the RP_AUTO_CR bit is set, the second coordinate is modified whenever the first coor¬ 
dinate reaches its boundary. For example, the call 

ChadWrite(ChadOwner(fp), FRAME , fp, FRCSR , (RP_INC_ADDR_MOD I RP_X_ADDR MOD I 

RPAUTOCR), NIX)\ 

sets the addressing mechanism to automatically pass through an image in scan line order, from top left to 
bottom right: pixel coordinates are incremented first in X then Y, and Y is incremented automatically at the 
end of each scan line (and, of course, X is restarted at the beginnning of the next scan line). 


The document Programming the Pixar with Chad discusses the principles behind Chad and gives opera¬ 
tional examples. The manual pages listed below give more terse explanations, with chad( 3H) being the 
most complete. 

LIBRARIES 

/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 

ERRORS 

All Chad routines return an error code, which is NULL (CHAD_NOERROR) for normal return. Once 
detected, a message explaining the error can be sent to a file with ChadErrReport( 3H). 

SEE ALSO 

libchad (3H), ChadBegin(3H), ChadAlloc(3H), ChadGo(3H), ChadErrReport(3H) 

The Chad Tutorial, in The Pixar User’s Manual, serves as an introduction to Pixar programming using the 
Chad routines. Also recommended is the Chap Programming Tutorial, in the same source, which 
discusses, indirectly, many of the tasks Chad performs invisibly. 
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NAME 

ChadGo, 

ChadCPUBusy, 

ChadWaitCPU - execute routines on a Chap 

SYNOPSIS 

# include "/usr/pixar/include/chad.h" 

ChadError ChadGo(pcp) 

ChadPC *pcp; 

ChadCPUBusy(chapid) 

ChapID chapid; 

ChadWaitCPU(chapid) 

ChapID chapid; 

DESCRIPTION 

Previously-allocated RAM resources (Chap functions) allocated using ChadAlloc(3U) may be executed by 
calling ChadGo. 

This execution routine is asynchronous, returning immediately when the Chap is started so that the host 
may continue its work concurrently. Synchronization may be accomplished by using ChadWaitCPU { 3H) 
to busily await the completion of the Chap on its appointed routines, or ChadCPUBusy (3H) to test whether 
the Chap is active. 

ChadCPUBusy and ChadWaitCPU are macros #defined in the include file chad.h. 


The document Programming the Pixar with Chad discusses the principles behind Chad and gives opera¬ 
tional examples. The manual pages listed below give more terse explanations, with chad{ 3H) being the 
most complete. 

LIBRARIES 

/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 

ERRORS 

All Chad routines return an error code, which is NULL (CHAD_NOERROR) for normal return. Once 
detected, a message explaining the error can be sent to a file with ChadErrReport( 3H). 

SEE ALSO 

libchad(3H), ChadBegin(3H), ChadAlloc(3H), ChadWrite(3H), ChadErrReport(3H), ChadFrame(3H) 

The Chad Tutorial , in The Pixar User’s Manual, serves as an introduction to Pixar programming using the 
Chad routines. Also recommended is the Chap Programming Tutorial , in the same source, which 
discusses, indirectly, many of the tasks Chad performs invisibly. 
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NAME 

ChadWrite, 

ChadRead - write/read Chap resources 

SYNOPSIS 

# include "/usr/pixar/include/chad.h" 

ChadError ChadWrite (chapid, 

[ SPAD, blockp, val, offset, ] 

[ SPAD ARRAY, blockp, vals, nwords, offset, ] 

[ PIXELS, blockp, pxvals, npixels, offset, ] 

[ FRAME, framep, FRX, x, ] 

[ FRAME} framep, FRY, y, ] 

[ FRAME, framep, FRCSR, csr, ] 

[ FRAME, framep, FRBFR, pxvals, xmin, xmax, ymin, ymax, ] 

[ SYSBUS<0..15>, val, ] 

[ R<0..31>, proc, val, ] 

[ ACC, proc, val, ] 

[ B<0..15>, val, ] 

[ I<0..15>, val, ] 

NIX) 

ChapID chapid; 

ChadSpad * blockp; 

int proc, nwords, npixels, offset, x, y, csr, 
xmin, xmax, ymin, ymax; 

ChadFrame *framep; 

CHAPVAL val, vals[ ]; 

RGBAPixelType pxvalsf ]; 

ChadError ChadRead(chapid, 

[ SPAD, blockp, valp, offset, ] 

[ SPADARRAY, blockp, vals, nwords, offset, ] 

[ SPADTAB, blockp, vals, nwords, offset, 3 
[ PIXELS, blockpp, pxvals, npixels, offset, ] 

[ FRAME, framep, FRX, xp, ] 

[ FRAME, framep, FRY, yp, ] 

[ FRAME, framep, FRCSR, csrp, ] 

[ FRAME, framep, FRBFR, pxvals, xmin, xmax, ymin, ymax, ] 

[ SYSBUS<0..13>, valp, ] 

[ R<0..31>, proc, valp, ] 

[ ACC, proc, valp, ] 

[ B<0..15>, valp, ] 

[ I<0..15>, valp, ] 

NIX) 

ChapID chapid; 

ChadSpad * blockp; 

int offset, nwords, npixels, proc, *xp, *yp, *csrp, xmin, xmax, ymin, ymax; 

ChadFrame *framep; 

RGBAPixelType pxvalsf ]; 

CHAPVAL *valp, vals[ ]; 

DESCRIPTION 

Once Chad resources have been allocated, ChadWrite (3H) will download data to them, and ChadRead 
(3H) will read data from them. In addition to resources explicitly allocated with ChadAlloc (3H), these 
functions will address various system registers: rO through r31 and acc refer to four-way ALU registers 
and accumulator, respectively; bO through b!5 and iO through i!5 refer to the base and index registers 
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associated with access to scratchpad memory; SYSBUSO through SYSBUS13 denote the memory-mapped 
sysbus registers of the Chap. SYSBUS14 and SYSBUS15 are reserved and unavailable via Chad. The proc 
parameter of the ALU registers is a bit mask indicating which processor gets or provides the value: 
CHAD_PROCR, CHAD_PROCG, CHAD_PROCB and CHAD_PROCA write to the red, green, blue and 
alpha processors, respectively. These may be combined bitwise to select any set of processors; 
CHAD_ALLPROCS is such a bit mask for them all. 

SPAD writes individual words to Scratchpad memory, while SPADARRAY writes to contiguous blocks of 
words. SPADTAB does the same, but writes them in a manner consistent with the ’index’ access mode of 
Chap routines. SPADTAB accesses are rare. PIXELS also reads and writes scratchpad, but in units of four 
words (pixels). 

The argument specifications denoted by FRAME refer to frames of image memory. The FRX and FRY 
specifications set the x and y coordinate of the current pixel, where this is defined relative to the boundaries 
of the frame. The FRCSR argument sets the access register of the frame, giving access permission and 
address-modification information for pixel access. Further details are available in ChadFrame(3 H). 

The document Programming the Pixar with Chad discusses the principles behind Chad and gives opera¬ 
tional examples. The manual pages listed below give more terse explanations, with chad{ 3H) being the 
most complete. 

LIBRARIES 

/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 

ERRORS 

All Chad routines return an error code, which is NULL (CHAD_NOERROR) for normal return. Once 
detected, a message explaining the error can be sent to a file with ChadErrReport( 3H). 

SEE ALSO 

libchad (3H), ChadBegin(3H), ChadAlloc(3H), ChadGo(3H), ChadErrReport(3H), ChadFrame(3H) 

The Chad Tutorial, in The Pixar User’s Manual, serves as an introduction to Pixar programming using the 
Chad routines. Also recommended is the Chap Programming Tutorial, in the same source, which 
discusses, indirectly, many of the tasks Chad performs invisibly. 
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NAME 

getchapsO, getvideo(), getdumiO, getmctrl(), getdiskwO - PIXAR special filename determination 
routines 

SYNOPSIS 

getchaps(chaparray) 
char *(* chaparrayG); 

getvideo( vidarray ) 
char *(* vidarrayG); 

getdumi( dumiarray ) 
char *(* dumiarrayG); 

getmctrl( mctrlairay ) 
char *(* mctrlarrayG); 

getdiskw( diskwarray ) 
char *(* diskwarrayG); 

DESCRIPTION 

The routines getchapsO, getvideo(), getdumiO, getmctrl(), and getdiskwO are used to determine the special 
filenames for PIXAR interfaces. getchapsO finds all attached Chap names. getvideo() finds all attached 
video board names. getdumiO finds all attached DUMI interface board names. getmctrl() finds all attached 
memory controller board names. getdiskwO finds all attached disk window (disk buffer) names. These 
routines are in the libchad.a library. 

The routines are called with the address of a variable declared to be a pointer to an array of character 
pointers. This variable is filled in with the address of a dynamically allocated array of pointers to the 
appropriate device names. A count of found device names is returned. If no device names are found, a 
count of 0 is returned. 

The list of found devices is sorted by minor device number, from lowest to highest. Devices are found by 
searching the /dev directory for all special files which have a specific major device number, and, where 
appropriate, testing for the presence of hardware. 

If the operating system is configured so that the PIXAR major device number is some value other than 34, 
a special file named /dev/dumiO must exist with the correct PIXAR major device number. This file, if it 
exists, provides the PIXAR major device number for the search. If the file does not exist, a default major 
device number of 34 is assumed. 

EXAMPLE 

/* Print out the names of all Chap devices */ 

#include <stdio.h> 

mainO 

{ 

char ** array; 
int cnt; 

cnt = getchaps( &array); 
while( cnt- ) 
puts( *array++); 

} 

ERRORS 

A count of zero is returned if no device names are found. This indicates an abnormal condition for a host 
equipped with a PIXAR Image Computer. Check to see if the special files for the PIXAR interface exist in 
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/dev. Make sure that the PIXAR computer cage is connected and has power applied. 
SEE ALSO 

CHAP(4G), DUMI(4), MCTRL(4G), VIDEO(4G) 

LIBRARY 

libchad.a 
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NAME 

FbGetDef, 

FbSetFbDefs, 

FbSetLfbDefs, 

FbSetFbPath, 

FbSetLfbPath - routines for defining and getting framebuffer definitions. 

SYNOPSIS 

#include <fbdefs.h> 

LfbDefType * FbGetDef(fbname) 
char *fbname; 

void FbSetFbDefs(fbdefs) 
char * fbdefs; 

void FbSetLfbDefs(lfbdefs) 
char *lfbdefs; 

void FbSetFbPath(fbpath) 
char *fbpath; 

void FbSetLfbPath(lfbpath) 
char *lfbpath; 

DESCRIPTION 

FbGetDef searches for fbname in the LFBPATH described in fbdefs( 7), and returns a pointer to the Ifbdef 
structure which describes the framebuffer information associated with fbname. The pfb element in the 
structure is a pointer to its pfbdef. The pwptr of the LfbDeJType and the tbptr of the FbDefType are not set 
by FbGetDef, but may be used by the application program to store PW and TB pointers. If the, fbname is a 
complete fbdef which is not in the LFBPATH, the fbdef is added to the ILFBDEFS, and a pointer to the 
structure is returned. If the fbname is only a name and is not in the LFBPATH, a null pointer is returned. 

FbSetFbDefs takes a colon-separated list of fbdefs and prepends it to the environment FBDEFS. 

FbSetLfbDefs takes a colon-separated list of Ifbdefs and prepends it to the environment LFBDEFS. 

FbSetFbPath takes a colon-separated list of fbnames and prepends it to the environment FBPATH. 

FbSetLfbPath takes a colon-separated list of Ifbnames and prepends it to the environment LFBPATH. 

LIBRARY 

libg.a 

SEE ALSO 

fbdefs(7), TB(3C), PW(3C) 
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NAME 

libpicio - picture encoding library 

DESCRIPTION 

libpicio is a library of C-callable functions for encoding, decoding, loading and unloading picture files. 
The following documentation exists for the picture encoding library routines: 

PicCreat (3H) discusses routines PicCreat, PicOpen , and PicFind for creating and opening picture files. 

PicRead (3H) documents the PicReadBuffer and PicWriteBuffer routines for communications between pic¬ 
ture tiles on disk and RGBA arrays in a program. 

PicClose (3H) documents the PicClose routine. 

Note the parallelism between the above routines and the creat, open, read, write, and close routines for nor¬ 
mal files. 

picDecode (3H) discusses the routines picPreDecodeScanline, picDecodeScanline, and picPostDecode- 
Scanline used for decoding individual scanlines of picture tiles on disk. These routines are provided as a 
more convenient alternative to the PicRead call. 

picEncode (3H) discusses the routines picPreEncodeScanline, picEncodeScanline, and picPostEncode- 
Scanline used for encoding individual scanlines of picture tiles on disk. These routines are provided as a 
more convenient alternative to the Write call. 

PicLabel (3H) discusses the routines PicLseekLabel, PicReadLabel , and PicWriteLabel , used for general 
reading and writing of arbitrary text information in the picture file. 

The header file picio.h includes all the picture file definitions needed for programs using picio routines. 
The file header addresses, specifying the position of the label, picture descriptor, and tile map, for example, 
are listed in this file. User access to header information should be done through library routines; the 
addresses are convenient for visual decoding of an octal dump. 

The major structure upon which pictures are based is the PictureDescriptor, defined in picio.h. Each pic¬ 
ture file on disk contains a PictureDescriptor in its header; each picture file referred to in a program is 
accessed via a pointer to a PictureDescriptor held in memory. User access to this structure is normally 
handled via library routines; occasional reading of individual fields is best handled directly. 

The currently stored fields of a PictureDescriptor are the height and width of die picture, the height and 
width of the tiles, the picture’s format, storage, blocksize, and matting indicator, and the x-y offsets of the 
picture. PictureDescriptors for open picture files include an open file number. The picture height (Pheight) 
and width ( Pwidth ) are the height and width of the picture in pixels. The tile height (Theight) and width 
C Twidth ) are the height and width of the tiles in pixels. Aside from being positive, these tile sizes have no 
restrictions. If not evenly divisible into the corresponding picture sizes, the rightmost and bottommost files 
will contain encoded pixel information not in the picture. We suggest that tiles not exceed 512 pixels in 
either dimension, so that 512-resolution frame buffers can be used for processing. 

The picture format ( [Pformat ) is a short which contains some union of the single bit entities PF_R (8), 
PF_G (4), PFJB (2), PF_A (1), all of which are defined in picio.h. The picture storage ( Pstorage ) indi¬ 
cates whether the stored file is 8 or 12 bits, encoded or dumped. Appropriate macros (PF_8BIT, etc.) are 
included. Pictures are blocked to speed their recovery; the blocksize (P blocksize) is tuned to the machine 
upon which the picture file was created (1024 on a VAX). The matting indicator ( Pmatting ) is important 
for files including both color and alpha information. The matte can be unassociated (PM_NONE) from the 
picture, associated (PM_MTB) in file standard matted-to-black fashion, or indirect (PM_IND) through the 
color map. 

The x-y offsets (Xoffset, Yoffset) indicate how many pixels to translate the upper left comer of the picture 
from the standard upper left comer origin of the frame buffer. 

Further macros listed in picio.h aid in computing the number of tiles (PM_NTILES(pdptr)) and number of 
components (PM NOFC(pdptr)) of a picture. 
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LIBRARY 

/usr/pixar/host/lib/libpicio.a 


SEE ALSO 

intro (1) 

- list of shell-callable Pixar programs 

intro (3C) 

- list of libraries of device-resident routines 

intro (3H) 

— list of libraries of host-resident routines 

PicClose (3H), PicCreat (3H), PicLabel (3H), PicRead (3H), picDecode (3H), picEncode (3H). 

LIST OF FUNCTIONS 

Name 

Appears on Page 

Description 

PicClose 

PicClose(3H) 

- close a picture file 

PicCreat 

PicCreat(3H) 

- create/open a picture file 

PicFind 

PicCreat(3H) 

- open a picture file, searching for it using PIXPATH 

PicGetFrame 

PicFrame(3H) 

- get pictures from frame buffer to picture file 

PicLseekLabel 

PicLabel(3H) 

- determine the length of a picture label 

PicOpen 

PicCreat(3H) 

- open a picture file 

PicPutFrame 

PicFrame(3H) 

- put pictures from picture file into frame buffer 

PicReadBuffer 

PicRead(3H) 

- read a picture tile 

PicReadLabel 

PicLabel(3H) 

- read a picture label 

PicSetForce 

PicCreat(3H) 

- force a picture-file overwrite 

PicSetLabel 

PicCreat(3H) 

- label a picture 

PicSetOffset 

PicCreat(3H) 

- set a picture’s offset 

PicSetPformat 

PicCreat(3H) 

- set format of a picture 

PicSetPmatting 

PicCreat(3H) 

- set a picture matting indicator 

PicSetPsize 

PicCreat(3H) 

- set size of a picture 

PicSetPstorage 

PicCreat(3H) 

- set a picture storage flag 

PicSetTsize 

PicCreat(3H) 

- set tile size of a picture 

PicWriteBuffer 

PicRead(3H) 

- write a picture tile 

PicWriteLabel 

PicLabel(3H) 

- write a picture label 

picDecodeScanline 

picDecode(3H) 

- decode a picture scan line 

picEncodeScanline 

picEncode(3H) 

- encode a picture scan line 

picPostDecodeScanline 

picDecode(3H) 

- finish decoding a picture tile 

picPostEncodeScanline 

picEncode(3C) 

- finish encoding a picture tile 

picPreDecodeScanline 

picDecode(3C) 

- start decoding a picture tile 

picPreEncodeScanline 

picEncode(3C) 

- start encoding a picture tile 
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NAME 

PicClose - close a picture file 

SYNOPSIS 

#include <picio.h> 

PicClose(channel) 

PFELE *channel; 

DESCRIPTION 

PicClose closes the picture file on this channel. 

LIBRARY 

/usr/pixar/host/lib/libpicio.a 
SEE ALSO 

libpicio (3H) - overview of the picio library 

PicCreat (3H), PicLabel (3H), PicRead (3H), picDecode (3H), picEncode (3H). 

DIAGNOSTICS 

This routine returns 0 if channel is not associated with an output file. 
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NAME 

PicCreat, 

PicSetPsize, 

PicSetTsize, 

PicSetPformat, 

PicSetPstorage, 

PicSetPmatting, 

PicSetOffset, 

PicSetForce, 

PicSetLabel, 

PicOpen, 

PicFind - create/open a picture file 

SYNOPSIS 

#include <picio.h> 

PFILE *PicCreat(filename, mode) 
char * filename; 
int mode; 

PicSetPsize(Pwidth,Pheight) 
int Pwidth,Pheight; 

PicSetT size(T width,Theight) 
int Twidth,Theight; 

PicSetPformat(PictureFormat) 
int PictureFormat; 

PicSetPstorage(PictureStorage) 
int PictureStorage; 

PicSetPmatting(PictureMatting) 
int PictureMatting; 

PicSetOflfset(Xoffset,Yoffset) 
int XofTset,Yoffset; 

PicSetForce(ForcedRemovalFlag) 
int ForcedRemovalFlag; 

PicSetLabel(labelptr) 
char *labelptr; 

PFILE *PicOpen(filename, type) 
char ^filename, *type; 

PFILE *PicFind(filename, type) 
char ^filename, *type; 

char *PicFindName; 


DESCRIPTION 

PicCreat creates a new picture file or prepares to rewrite an existing file called filename, and associates a 
picture descriptor (PFILE) with it PicCreat returns a pointer to identify the picture descriptor in 
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subsequent operations. If the file did not exist, it is given the mode mode, as modified by the process’s 
mode mask. If the file exists and is protected against overwriting, the routine will ask permission to 
overwrite unless a call PicSetForce(TRUE) has been made. 

The picture width (512), picture height (488), tile width (512), tile height (488), picture format 
(PF_RGBA), picture storage flag (PS_8BIT), picture matting indicator (PM MTB), and picture offsets 
(0,0) (see <picio.h>) are all stored in the picture descriptor associated with this channel. The default values 
are shown in parentheses; these can be changed with calls to the various PicSet... routines. 

An ASCII picture label is written if PicSetLabel has been called, passing a label pointer. 

The picture format is one of (PF_RGBA, PF_RGB, PF_R, PF_G, PF B, PF A) corresponding to 4, 3, 
and 1 channel images. The picture storage should normally be PS_8BIT indicating that 8 bits of each 
channel is saved in a run-length-encoded manner. Dump mode is now supported, so natural images might 
well be PS_8DUMP to indicate an 8-bit per channel dumped format. Virtual frame buffers are saved as 
PS_12DUMP to indicate a 12-bit per channel dumped format A 12-bit encoded storage scheme is also 
supported, flagged by PS_12BIT. The picture matting indicator is relevant only for pictures including an 
alpha channel, and should be PM_MTB for matted-to-black pictures and PM_NONE for unassociated pic¬ 
tures. Tile sizes are suggested to be no bigger than 512 by 512 so that current frame buffers can be used 
for manipulation of pictures on a tile by tile basis. 

PicOpen opens the picture named by filename and associates a channel with it. PicOpen returns a pointer 
to be used to identify the picture descriptor in subsequent operations. 

Type is a character string having one of the following values: 

“r” open for reading 

“w” open for writing 

“r+” open for both 

“ w+’ ’ create and open for both. 

PicFind is just like PicOpen, except that it searches PIXPATH to find filename before opening it. The glo¬ 
bal PicFindName is a char pointer pointing to the full specification of the opened file. 

LIBRARY 

/usr/pixar/host/lib/libpicio.a 
SEE ALSO 

libpicio (3H), open(2), creat(2), fopen(3) 

PicClose (3H), PicLabel (3H), PicRead (3H), picDecode (3H), picEncode (3H). 

DIAGNOSTICS 

PicCreat, PicOpen and PicFind return the pointer NULL if filename cannot be accessed. PicCreat will 
return the pointer NULL if the header information is illegal. 
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NAME 

picPreDecodeScanline, 

picDecodeScanline, 

picPostDecodeScanline - sequential decoding of tile from disk 

SYNOPSIS 

#include <picio.h> 

picPreDecodeScanline(channel, tilenumber) 

PFILE ^channel; long tilenumber; 

char * picDecodeScanline(channel, ptr) 

PFILE *channel; RGBAPixelType *ptr; 

picPostDecodeScanline(channel) 

PFILE * channel; 

DESCRIPTION 

These routines are offered as an alternative to the PicReadBujfer routine, described elsewhere, which con¬ 
verts one entire tile from disk to memory buffer. These routines allow the sequential decoding of indivi¬ 
dual scanlines of a tile from disk to a scanline memory buffer. These routines are fragile in the sense that 
the described order must be followed exactly to produce a correctly decoded picture. If a tile has width w 
and height h, there should be an RGBAPixelType buffer of w pixels. There should be one call to 
picPreDecodeScanline, h calls to picDecodeScanline, and one call to picPostDecodeScanline. 

picPreDecodeScanline initiates the decoding of a tile with tile number tilenumber in the picture header. 
Note that tile numbers begin at zero. Zero is returned if the tile does not exist. It is very possible to create 
pictures with some tiles missing. Whether this means “all pixels black” or “no picture at all” is your 
choice. picDecodeScanline decodes the next scanline of the named picture output channel into a scanline 
RGBA buffer beginning at ptr. A global variable picDecodeEmpty is set non-zero if the decoded scanline 
has an alpha channel that is zero everywhere. A global variable picDecodeFull is set non-zero if the 
decoded scanline has an alpha channel that is unity everywhere. Because the alpha channel defaults to 
unity, the decoding of any picture not including alpha will force picDecodeFull on at every scanline. 
picDecodeScanline returns a char pointer, which should point beyond the last pixel of the scanline buffer. 

picPostDecodeScanline ends the decoding of this tile. 

LIBRARY 

/usr/pixar/host/lib/libpicio.a 
SEE ALSO 

libpicio (3H) - overview of the picio library 

PicClose (3H), PicCreat (3H), PicLabel (3H), PicRead (3H), picEncode (3H). 

BUGS 

Abuse of the lseek pointer into the open picture file may wreak havoc. 

DIAGNOSTICS 

picPreDecodeScanline will return 0 if the tilenumber is bad or internal buffer space cannot be allocated. 
picDecodeScanline will return 0 if picPreDecodeScanline has not been called or if we reach the end of file 
in the midst of decoding. picPostDecodeScanline will return 0 if the number of calls to picDecodeScanline 
is not equal to the height of the tile. 
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NAME 

picPreEncodeScanline, 

picEncodeScanline, 

picPostEncodeScanline - sequential encoding of a tile to disk 

SYNOPSIS 

#include <picio.h> 

picPreEncodeScanIine(channel,tilenumber) 

PFILE *channel; long tilenumber; 

char * picEncodeScanline(channel, ptr) 

PFILE *channel; RGBAPixelType *ptr; 

picPostEncodeScanline(channel) 

PFILE * channel; 

DESCRIPTION 

These routines are offered as an alternative to the PicWriteBujfer routine, described elsewhere, which con¬ 
verts one entire tile from memory buffer to disk. These routines allow the sequential encoding of indivi¬ 
dual scanlines of a tile from a scanline memory buffer to disk. These routines are fragile in the sense that 
the described order must be followed exactly to produce a correctly encoded picture on disk. If a tile has 
width w and height h, there should be a RGBAPixelType buffer of w pixels. There should be one call to 
picPreEncodeScanline, h calls to picEncodeScanline, and one call to picPostEncodeScanline. 

picPreEncodeScanline initiates the encoding of a tile and associates the encoded information with tile 
number tilenumber in the picture header. Note that tile numbers begin at zero. Zero is returned upon 
failure to write this pointer. picEncodeScanline uses a scanline RGBA buffer beginning at ptr to encode 
the next scanline of the named picture output channel. 

picPostEncodeScanline ends the encoding of this tile. 

LIBRARY 

/usr/pixar/host/lib/libpicio.a 
SEE ALSO 

libpicio (3H) - overview of the picio library 

PicClose (3H), PicCreat (3H), PicLabel (3H), PicRead (3H), picDecode (3H) 

BUGS 

Abuse of the lseek pointer into the picture being encoded will trash the encoding. Although concurrent 
encoding is supported, concurrent encoding of tiles in the same picture is not 

DIAGNOSTICS 

picPreEncodeScanline returns 0 if the tilenumber is bad or internal buffer space cannot be allocated. 
picEncodeScanline returns 0 if picPreEncodeScanline has not been called or upon any disk write error (i.e., 
when there is no more space). picPostEncodeScanline returns 0 if the number of calls to picEncodeScan¬ 
line is not equal to the height of the tile. This indicates a malformed tile. 
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NAME 

PicGetFrame, 

PicPutFrame - get/put pictures from frame buffer to picture file 

SYNOPSIS 

#include <picio.h> 

#include <chad.h> 

PicPutFrame( pdptr, fbptr, xoffset, yoffset, xmin, xmax, ymin, ymax, tile, channels, host) 

PFILE *pdptr; 

ChadFrame *fbptr; 

int xoffset, yoffset, xmin, xmax, ymin, ymax; 
int tile, channels, host; 

PicGetFrame( pdptr, fbptr, xoffset, yoffset, host) 

PFILE *pdptr; 

ChadFrame * fbptr; 
int xoffset, yoffset; 
int host; 

DESCRIPTION 

These procedures copy images from picture files to and from frame buffer memory. The function PicGet¬ 
Frame corresponds roughly to the command line program sv(l), and PicPutFrame corresponds to the pro¬ 
gram gt( 1). These names are not backwardsX**-a host programmer made them up, that’s all. 

PicGetFrame copies an image from Pixar frame buffer memory into a picture file. The picture file is 
described by a picture descriptor pointer, pdptr , which is usually obtained by calling PicCreat( 3H). The 
attributes of the picture file (for example, its dimensions and storage format), are set before the call to Pic- 
Creat. Functions to set these parameters are described in PicCreat(3H). The rectangular window within 
the Pixar frame buffer memory from which the picture is copied is described by a ChadFrame pointer, 
fbptr , which is obtained by a call to ChadAlloc( 3H). The origin of the picture is given by the point (xoffset, 
yoffset). The coordinates of this point are relative to the frame buffer window, that is, (0,0) is the upper-left 
hand comer. As mentioned previously, the size of the picture is determined by the picture dimensions in 
the picture file descriptor. If the flag host is true, the picture is encoded on the host. Normally, this should 
be false allowing the Chap to do the encoding since this is much faster. 

PicPutFrame copies an image stored in a picture file into Pixar frame buffer memory. A picture file 
descriptor, pdptr, corresponding to the already created picture file to be transferred, should be obtained 
using PicFind(3 H). If the variable tile is less than 0, all the tiles in the picture file are transferred. If it is 
greater than or equal to 0, only the corresponding numbered tile is copied. A rectangular window in the 
frame buffer is described by a ChadFrame pointer, fbptr, which is obtained by calling ChadAlloc. A clip¬ 
ping rectangle can be specified by giving its x-range (xmin, ymin) and y-range (ymin, ymax). The coordi¬ 
nates of the clipping rectangle are specified relative the the pixel window (so that (0,0) is the upper-left 
comer). If the point (xoffset, yoffset) equals (0,0) the picture is copied so that its upper-left hand comer is 
aligned with the frame buffer window’s upper-left hand comer. Positive x offsets move the picture to the 
right and positive y offsets move the picture down. The variable channels is a bit-mask that specifies the 
channels in the frame buffer, which are written (r=l, g=2, b=4, a=8). Finally, the boolean variable host 
controls whether the decoding takes place in the host or in the chap. Normally, this is set to 0 indicating 
that the chap does the decoding since this is much faster. Unfortunately, not all picture file formats can be 
encoded in the chap, and sometimes this flag is overridden. 

EXAMPLES 

The simplest code to copy a picture into the Pixar frame buffer would look something like this: 
ChadAlloc(0, TB, &tbp, 0, 32,24, FRAME, &fbp, &tbp, 0,1023,0,767, NIX); 
pdptr = PicFind( "reyes","r"); 

PicPutFrame( pdptr, fbp, 0,0,0,1023,0 767, -1, channels=0xf, host=0); 
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PicClose(pdptr); 

The simplest code to store a picture from the Pixar frame buffer would look something like this (assuming 
the same ChadFrame as above): 

PicSetPsize(picturewidth, pictureheight); 

PicSetTsize(picturewidth, pictureheight); 

PicSetPformat(pictureformat); 

PicSetOffset(xmin, ymin); 

pdptr = PicCreat(filename,mode); 

PicGetFrame( pdptr, fbp, xmin, ymin, host=0); 

PicClose(pdptr); 

BUGS 

Currently, only the following formats are encoded and decoded by the Chap: PF_RGBA, PF_RGB, PF_R. 

If for some reason the chap cannot allocate all the resources it needs, the host performs the encoding and 
decoding. 

LIBRARY 

/usr/pixar/host/lib/libpicio.a 
SEE ALSO 

gt(l), sv(l), libpicio(3H), ChadAlloc(3H), PicCreat(3H). 
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NAME 

PicLseekLabel, 

PicReadLabel, 

PicWriteLabel - handle picture labels 

SYNOPSIS 

#include <picio.h> 

long PicLseekLabeI(pdptr, offset, whence) 

PFILE *pdptr; 
long offset; 
int whence; 

int PicReadLabel(pdptr, bulfer, nbytes) 

PFILE *pdptr; 
char *buffer; 
int nbytes; 

int PicWriteLabel(pdptr, buffer, nbytes) 

PFILE *pdptr; 
char * bulfer; 
int nbytes; 

DESCRIPTION 

The picture descriptor pdptr refers to a picture file open for reading or writing. The pointer for the file is 
set as follows: 

If whence is 0, the pointer is set to offset bytes. 

If whence is 1, the pointer is set to its current location plus offset. 

If whence is 2, the pointer is set to the end-of-label plus offset. The end-of-label is taken as the 
first null character after the start of the label. 

The returned value is the resulting offset into the label; -1 is returned in case of invalid picture descriptor, 
seek to a position before the start of the label, or improper whence. The read/write pointer is untouched by 
the first and last errors; the pointer is set to zero after an attempt to seek a position before the start of the 
label. 

PicReadLabel reads the next nbytes bytes of the picture label into the array buffer. It is not guaranteed that 
all nbytes bytes will be read. Furthermore, it may read past the end-of-label, leaving the read/write pointer 
beyond the first null character of the label. In any event, the number of characters read is returned as the 
value of the procedure. 

If the returned value is less than nbytes, end-of-label has been reached and likely overrun. If you need 
accuracy in the length of label, use the returned value from PicLseekLabel(pdptr,0,2). 

PicWriteLabel writes the next nbytes bytes into the picture label from the array buffer. The number of char¬ 
acters written is returned. Writing a null character in the midst of the buffer will induce an end-of-label 
and set the read/write pointer beyond this end-of-label. 

The PicSetLabel(labelptr) routine described along with PicCreat is equivalent to a 
PicLseekLabel(pdtpr,0,0) followed by a PicWriteLabel(pdptr,labelptr,strlen(labelptr)) in writing the label 
and setting the label lseek pointer. 

PicCreatQ and PicOpenQ set the read/write pointer of the label to zero. 

LIBRARY 

/usr/pixar/host/lib/libpicio.a 
SEE ALSO 

libpicio (3H) - overview of the picio library 

PicClose (3H), PicCreat (3H), PicRead (3H), picDecode (3H), picEncode (3H). 
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NAME 

PicReadBuffer, 

PicWriteBuffer - tile to buffer I/O 

SYNOPSIS 

#include <picio.h> 

PicReadBuffer (channel, ptr, tilenumber) 

PFILE *channel; RGBAPixelType *ptr; long tilenumber; 

PicWriteBuffer(channel, ptr, tilenumber) 

PFILE *channel; RGBAPixelType *ptr; long tilenumber; 

DESCRIPTION 

PicReadBuffer reads, into a block beginning at ptr, pixel by pixel contents of tile tilenumber from the 
named picture input channel. It returns the number of scanlines actually read. 

PicWriteBuffer writes the pixel by pixel contents of the buffer starting at ptr into tile number tilenumber to 
the named picture output channel. It returns the number of scanlines actually written. 

Note that tile size information is accessible through the channel pointer. 

LIBRARY 

/usr/pixar/host/lib/libpicio.a 

SEE ALSO 

libpicio(3H) 

read(2), wnte(2), PicOpen(3H), PicClose (3H), PicCreat (3H), PicLabel (3H), picDecode (3H), picEncode 
(3H). 

DIAGNOSTICS 

Pread and Pwrite return 0 upon end of file or error. 
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NAME 

libpirl - Introduction to Pixar Resource Library 

DESCRIPTION 

Libpirl is a set of C-callable functions for working with rectangular pixel windows on the Pixar. Some rou¬ 
tines, e.g., PirlClamp , PirlReflectX, accept only a pixel window in order to perform their operation. Most of 
the routines need additional parameters, such as a color, or numeric values (e.g., PirlClear , PirlAddl, 
respectively) in order to operate on the pixel window. A few routines, such as PirlCopy and PirlSwap , 
accept two pixel windows. 

This library also includes several image processing routines such as boxfilter, convolve and blur. 

It is the user’s responsibility to begin and end the Chad environment, and allocate and deallocate valid 
pixel windows via ChadAlloc. Libpirl routines will allocate and deallocate temporary storage, such as 
scanline buffers, as needed. 

Each of these routines returns the token PIRLNOJERROR if it completed successfully. Error checking 
and recovery is explained in more detail in the The Pirl Tutorial. 

SEE ALSO 

intro(l), intro(3Q, intro(3H), libchad(3H) 


LIST OF FUNCTIONS 


Name 

Mapfcn 

PirlAdd 

PirlAffine 

PirlAxb 

PirlBBox 

PirlBegin 

PirlBeginLines 

PirlMulI 

PirlDivI 

PirlAddl 

PirlSubI 

PirlBoxFilterX 

PirlBoxFilterY 

PirlCbars 

PirlCha 

PirlCircularShift 

PirlClamp 

PirlClear 

PirlConvolveX 

PirlConvolveY 

PirlConvolve3x3 

PirlConvolve3x3s 

PirlCopy 

PirlCopyGeneric 

PirlCrc 

PirlDiv 

PirlDisplay 

Pirlknd 

PirlEndLines 

PirlErrReport 

PirlGetBuf 

PirlGetFrame 

PirlGetPic 


Appears on Page 

PirlMakeMap(3H) 

PirlArithmetic(3H) 

PirlAffine(3H) 

PirlAxb(3H) 

PirlBBox(3H) 

PirlBegin(3H) 

PirlLine(3H) 

PirlAxb(3H) 

PirlAxb(3H) 

PirlAxb(3H) 

PirlAxb(3H) 

PirlBoxFilter(3H) 

PirlBoxFilter(3H) 

PirlCbars(3H) 

PirlCha(3H) 

PirlShift(3H) 

PirlClamp(3H) 

PirlClear(3H) 

PirlConvolve(3H) 

PirlConvolve(3H) 

PirlConvolve3x3(3H) 

PirlConvolve3x3(3H) 

PirlCopy(3H) 

PirlCopy(3H) 

PirlCrc(3H) 

PirlArithmetic(3H) 

PirlDisplay(3H) 

PirlBegin(3H) 

PirlLine(3H) 

PirlErrReport(3H) 

PirlGetBuf(3H) 

PirlFrame(3H) 

PirlGetPic(3H) 


Description 

- Mapping function for PirlMakeMap 

- add two pixel windows 

- Perform an affine transformation on a pixel window 

- compute new pixel = a*pixel+6 for a pixel window. 

- determine the smallest rectangle that surrounds an image 

- Pixar runtime environment entry/exit 

- Draw lines in a pixel window 

- compute new pixel = a*pixel for a pixel window. 

- compute new pixel = pixel/a for a pixel window. 

- compute new pixel = pixel+6 for a pixel window. 

- compute new pixel = pixel-6 for a pixel window. 

- convolve pixel window buffer with 1-d pulse (box) 

- convolve pixel window buffer with 1-d pulse (box) 

- display color bars 

- perform linear arithmetic on framebuffer channels 

- circular shift pixel window contents in x and/or y 

- clamp pixel between 0.0 (0) and 1.0 (0x800) for a pixel window 

- clear pixel window to color 

- convolve a pixel window with a 1-d kernel 

- convolve a pixel window with a 1-d kernel 

- convolve pixel window with a separable 3x3 matrix 

- convolve pixel window with a 3x3 kernel 

- copy the source pixel window to the destination pixel window 

- PirlCopy with user-specified axes, start and direction parameters 

- performs a Cyclic Redundency Check (CRC) on a pixel window 

- divide two pixel windows 

- Display a pixel window on the monitor 

- Pixar runtime environment entry/exit 

- Draw lines in a pixel window 

- print a descriptive error message explaining the last error 

- Get/put a block of pixels from/to a pixel window 

- get a buffer into a pixel window 

- Get/save a pixel window from/to a disk file 
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PirlGetRaster PirlGetRaster(3H)- get a raster image file into a pixel window 

PirlHistogram PirlHistogram(3H) - accumulate frequency histogram of a pixel window 

PirlLineEdgeDesc PirlLine(3H) - Set line characteristics 

PirlMakeMap PirlMakeMap(3H) - create a map for changing the colors of a pixel window 

PirlMap PirlMap(3H) - remap the colors of a pixel window 

PirlMerge PirlMerge(3H) - composite a foreground with a background 

PirlMul PirlArithmetic(3H) - multiply two pixel windows 

PirlNot PirlNot(3H) - subtract pixel value from 1.0 (0x800) for a pixel window 

PirlPolyLine PirlLine(3H) - Set line characteristics 

PirlPutBuf PirlGetBuf(3H) - Get/put a block of pixels from/to a pixel window 

PirlPutFrame PirlFrame(3H) - put a a buffer into a pixel window 

PirlRampX PirlRamp(3H) - draw a ramp into a pixel window 

PirlRampY PirlRamp(3H) - draw a ramp into a pixel window 

PirlRange PirlRange(3H) - find the minimum and maximum pixel values in a pixel window 

PirlReflectX PirlReflect(3H) - reflect the pixel window around its center horizontal axis 

PirlReflectY PirlReflect(3H) — reflect the pixel window around its center vertical axis 

PirlResize PirlResize(3H) - copy the source pixel window to the destination pixel window 

PirlSavePic PirlGetPic(3H) - Get/save a pixel window from/to a disk file 

PirlSetChannelMask PirlSetChannelMask(3H) — set a pixel window’s channel mask 
PirlSetLineColor PirlLine(3H) — Set line characteristics 

PirlSetLineEdge PirlLine(3H) - Set line characteristics 

PirlSetLineMode PirlLine(3H) — Set line charac te ristics 

PirlSetLineWidth PirlLine(3H) — Set line characteristics 


PirlShift PirlShift(3H) - shift pixel window contents in x and/or y 

PirlShuffle PirlShuffle(3H) - shuffle components of each pixel for a pixel window 

PirlSub PirlAnthmetic(3H) — subtract two pixel windows 

PirlSwap PirlSwap(3H) - swap the source pixel window and the destination pixel window 

PirlSweepX PirlSweep(3H) - copy a column of pixels repeatedly into a pixel window 

PirlSweepY PirlSweep(3H) - copy a row of pixels repeatedly into a pixel window 

PirlTranspose PirlTranspose(3H) - transpose a pixel window around the diagonal axis 

PirlZoom PirlZoom.3h - Zoom in on a pixel window on the monitor 
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NAME 

PirlAffine - Perform an affine transformation on a pixel window 

SYNOPSIS 

#include <chad.h> 

#include <pirl.h> 

PirlError 

PirlAffine(srcpw,tmppw,dstpw,transf,clr,extent) 

ChadPW *srcpw, *tmppw, *dstpw; 
double transf[3][2]; 
int dr,extent; 

DESCRIPTION 

PirlAffine performs an affine transformation on a source pixel window and places the result in a destination 
pixel window. The transformation is performed using a two-pass (horizontal and vertical) resampling algo¬ 
rithm. 

Source and destination pixel windows are specifed for each pass of the resampling algorithm. The source 
and destination pixel windows for each pass cannot partially overlap, srcpw defines the transformation 
source pixel window, tmppw defines the destination window for the first (intermediate) pass and the 
source for the second pass, dstpw defines the the destination for the second (final) pass. If the dstpw is 
smaller than the srcpw, the tmppw must be greater than or equal to the size of the srcpw. The transforma¬ 
tion can be done in place, so srcpw, tmppw, and dstpw can all point to the same pixel window. 

transf specifies the affine transformation matrix. The first column of the matrix 
defines the coefficients for x’, such that: x’ = Ax + By + C. The second column defines 
the coefficients for y’, such that: y’ = Ax + By + C. 
clr is a flag wich specifies whether PirlAffine should clear out its borders. 

extent specifies the filter width (in pixels). An extent of four will use a cubic filter. An extent of two will 
use a linear filter. 

FILES 

/usr/pixar/host/src/lib/libpirl/affine.c 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a /usr/pixar/host/lib/libpixar.a 
SEE ALSO 

Rotate(l), PirlRotate(3h), PirlShear(3h), PWShear(3c) 
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NAME 

PirlAdd - add two pixel windows 

PirlSub - subtract two pixel windows 

PirlMul - multiply two pixel windows 

PirlDiv - divide two pixel windows 

SYNOPSIS 

#include M /usr/pixar/incIude/pirl.h H 
PirlError 

PirlAdd ( dstpw, srcpw ) 

ChadPW *dstpw, *srcpw; 

PirlError 

PirlSub ( dstpw, srcpw ) 

ChadPW *dstpw, ’"srcpw; 

PirlError 

PirlMul ( dstpw, srcpw ) 

ChadPW *dstpw, *srcpw; 

PirlError 

PirlDiv ( dstpw, srcpw ) 

ChadPW *dstpw, *srcpw; 

DESCRIPTION 

These procedures perform image arithmetic on two pixel windows. Pixel values within a window are 
treated as 11-bit fixed point quantities. Therefore, 2048*2048=2048 and 2048/2048=2048. PirlAdd com¬ 
putes dstpw += srcpw, PirlSub computes dstpw -= srcpw, PirlMul computes dstpw *= srcpw, and PirlDiv 
computes dstpw / = srcpw. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/Iib/libchad.a/usr/pixar/host/lib/libpixar.a 

SEE ALSO 

PirlCha(3H), PirlAxb(3H) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User's Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlAxb - compute new pixel = a*pixel+6 for a pixel window. 

PirlMulI - compute new pixel = a*pixel for a pixel window. 

PirlDivI - compute new pixel = pixel/a for a pixel window. 

PirlAddI - compute new pixel = pixel+6 for a pixel window. 

PirlSubI - compute new pixel = pixel-b for a pixel window. 

SYNOPSIS 

#include H /usr/pixar/include/pirl.h H 
PirlError 

PirlAxb (pw, a, b) 

ChadPW *pw; 

RGBAPixelType *a,*b; 

PirlError 
PirlMulI (pw, a) 

ChadPW *pw; 

RGBAPixelType *a; 

PirlError 
PirlDivI (pw, a) 

ChadPW *pw; 

RGBAPixelType *a; 

PirlError 
PirlAddI (pw, b) 

ChadPW *pw; 

RGBAPixelType *b; 

PirlError 
PirlSubI (pw, b) 

ChadPW *pw; 

RGBAPixelType *b; 

DESCRIPTION 

PirlAxb computes a new pixel value by multiplying each pixel component by the appropriate components 
of a and adding b. The factors are four-way 11-bit values, where 1.0E (2048) equals 1.0. This function is 
useful for performing simple channel arithmetic. 

PirlMulI and PirlDivI are equivalent to PirlAxb with the b pixel set to zero. The division function com¬ 
putes the reciprocal of a, then calls PirlAxb with this new value. 

PirlAddI and PirlSubI set the a components to 1.0E (2048) before calling PirlAxb. The subtract routine 
subtracts b from the pixel value instead of adding it. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a /usr/pixar/host/lib/libpixar.a 
SEE ALSO 

PWAxb(3C), SS Axb(3C), PirlCha(3H) 

The Chad Tutorial , and also the Chap Programming Tutorial in The Pixar User’s Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

PirlDivI returns PIRL_AXB_DIV_BY_ZERO if asked to divide by a zero component. 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlBBox - determine the smallest rectangle that surrounds an image 

SYNOPSIS 

#include M /usr/pixar/incIude/pirl.h M 
PirlError 

PirlBBox (pw,background,xmin,xmax,ymin,ymax) 

ChadPW *pw; 

RGBAPixelType * background; 
int *xmin, *xmax, *ymin, *ymax; 

DESCRIPTION 

PirlBBox finds the smallest rectangle (bounding box) that surrounds an image in the given pixel window. 
This can be used to make a smaller pixel window so that subsequent processing is performed on smaller 
images and takes less time. 

The color background is used to determine whether the image data is present If the color equals back¬ 
ground image data is assumed not to be present; if, on the otherhand, the color is not equal to background, 
image data is assumed to be present. Normally, background is set to (0,0,0,0). 

The edges of the bounding rectangle are returned in ( xmin, xmax, ymin, ymax ). These coordinates are rela¬ 
tive to the pixel window. If the entire pixel window contains valid image data, (xmin,ymin) will equal 
(0,0), and (xmax,ymax) will equal the width and height of the pixel window, respectively. 

LIBRARIES 

/usr/pixar/host/libAibpirl.a/usr/pixar/host/lib/libchad.a /usr/pixar/host/lib/libpixar.a 

SEE ALSO 

PWBBox (3C) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User’s Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlBegin, PirlEnd - Pixar runtime environment entry/exit 


SYNOPSIS 


# include ,, /usr/pixar/mclude/pirl.h H 

# define STD_TB i^j_DESCRIP(0, 32, 24) 

# define BIG TB MjDESCRIP(0, 32, 128) 


# define HUGE TB N 


}_DESCRIP(0, 32, 256) 

dKoJU 


extern PirlTB ThePiriTB; 
extern PirlPW ThePirlPW; 
extern Video ThePirlVideo; 




PirlError PirlBegin(chapid, FBDESCRIP( firsttile, nxtiles, nytiles)) 

ChapID chapid; 

int firsttile, nxtiles, nytiles; 


PirlError PirlEnd () 


DESCRIPTION 

Pirl (Pixar Runtime Library) provides simplified access to routines which access rectilinear regions of 
image memory on the Pixar Image Computer. It also maintains a simple runtime environment, which must 
be entered with PirlBegin 0 and exited with PirlEnd 0- The former takes two arguments: a ChapID 
(almost invariably the constant CHAPO as defined for Chad), indicating which Chap Pirl’s microcode will 
run on; and a frame buffer descriptor, usually one of STD_TB (for 1024x768-pixel displays), BIGTB 
(ditto, but including substantial offscreen frame buffer) or HUGE_TB (likewise, and including all offs¬ 
creen frame buffer in the largest available Pixar Image Computer). PirlBeginO allocates ThePiriTB and 
ThePirlPW, a tile block and pixel window encompassing the tiles given in its argument list. These are a 
convenience to be used in other Pirl calls. 


Pirl defines two data types, PirlTB and PirlPW. These are the same as ChadTB and ChadPW, respec¬ 
tively, except that Pirl retains a record of all pixel windows that were allocated via PirlNewPW (3H), so 
they can be automatically deallocated via PirlEndO. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 

SOURCE 

/usr/pixar/host/src/lib/libpirl/begin.c - source for PirlBeginO and 

PirlEnd 0 

SEE ALSO 

libpirl(3H), PirlNewPW(3H) 

The Pirl Tutorial, in The Pixar Programmer’s Manual, serves as an introduction to Pixar programming 
using Pirl. 
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NAME 

PirlBoxFilterX, 

PirlBoxFilterY - convolve pixel window buffer with 1-d pulse (box) 

SYNOPSIS 

#include "/usr/pixar/include/pirl.h" 

PirlError 

PirlBoxFilterX(pw, width, highpass, a, b) 

ChadPW *pw; 
int width, highpass; 
double a, b 

PirlError 

PirIBoxFilterY(pw, width, highpass, a, b) 

ChadPW *pw; 
int width, highpass; 
double a, b 

DESCRIPTION 

PirlBoxFilterX and PirlBoxFilterY performs a one-dimensional convolution of the image stored in the pixel 
window. An image can be convolved with a 2-d pulse function by first convolving in x, and then convolv¬ 
ing in y. 

The convolution is done by summing the center pixel plus the width pixels preceding and following it. 
Therefore, the total width of the pulse is 2*width+l pixels. PirlBoxFilterX sums the pixels horizontally, 
while PirlBoxFilterY sums them vertically. 

If the flag highpass is non-zero, the result of the convolution is subtracted from the value of the center 
pixel. This creates a highpass filter. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a /usr/pixar/host/lib/libchad.a/usr/pixar/host/libAibpixar.a 
SEE ALSO 

PirlConvolve3x3(3H), PirlConvolve(3H), PWBoxFilter(3C) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User's Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlCbars - display color bars 

SYNOPSIS 

#include M /usr/p ixar/include/pir l.h " 

#include "/usr/pixar/include/cbars.h” 

PirlError PirlCbars(pw, type) 

ChadPW *pw; 
int type; 

DESCRIPTION 

PirlCbars displays color bars for 3-quarters the length of a pixel window, pw. These options are controlled 
by the type, as follows: 

NORMAL 
CBS 
FULL 
REVERSE 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a /usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 

SEE ALSO 

cbars(l) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User’s Manual , discuss alloca¬ 
tion of pixel windows. 


- draw conventional color bars 

- draw CBS colorbars 

- draw full-length bars 

- draw reverse bars at the bottom 
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NAME 

PirlCha - perform linear arithmetic on framebuffer channels 

SYNOPSIS 

#include "/usr/pixar/include/pirLh" 

PirlError PirlChafpw, coeffs) 

ChadPW *pw; 
double coeffs[4][5]; 

DESCRIPTION 

PirlCha generates a color at each pixel of a pixel window, pw. The channels of each output pixel are a 
linear combination of the original channel values, as given by the matrix coeffs. The first row of the matrix 
generates the new Red channel value by multiplying the input channel values by the first four elements, 
then adding the fifth. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/Iibchad.a/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

PWCha(3C), SSCha(3C) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User's Manual, discuss alloca¬ 
tion of pixel windows. 
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NAME 

PirlClamp - clamp pixel between 0.0 (0) and 1.0 (0x800) for a pixel window 

SYNOPSIS 

#include "/usr/pixar/include/pirl.h" 

PirlError 
PirlClamp (pw) 

ChadPW *pw; 

DESCRIPTION 

PirlClamp clamps each pixel in a pixel window to a minimum of 0.0 (0) and a maximum of 1.0E (2048). 
This is useful for removing the values outside this range occasionally produced by filtering. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 

SEE ALSO 

SSClamp(3C), PWClamp(3C) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User's Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlClear - clear pixel window to color 

SYNOPSIS 

#include "/usr/pixar/include/pirl.h" 

PirlError 

PirlClear (pw,color) 

ChadPW *pw; 

RGBAPixelType * color; 

DESCRIPTION 

PirlClear clears the pixel window to color. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a /usr/pixar/host/lib/libchad.a /usr/pixar/host/lib/libpixar.a 

SEE ALSO 

PWClear(3C) 

The Chad Tutorial , and also the Chap Programming Tutorial in The Pixar User’s Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlConvolveX, 

PirlConvolveY - convolve a pixel window with a 1-d kernel 

SYNOPSIS 

#include "/usr/pixar/include/pirl.h" 

PirlError 

PirlConvolveX(pw, kernel, kernelsize) 

ChadPW *pw; 
double kernelf]; 
int kernelsize; 

PirlError 

PirlConvolveY(pw, kernel, kernelsize) 

ChadPW *pw; 
double kernelf] 
int kernelsize; 

DESCRIPTION 

PirlConvolveX and PirlConvolveY convolve the image in the pixel window with a 1-dimensional kernel. In 
the X version, the kernel extends kernelsize pixels along the x axis. In the Y version, the kernel is aligned 
with the y axis. The result is placed in the same pixel window. 

The kernel is an array of kernelsize doubles. The variable offset specifies which entry of the kernel matrix 
kernel corresponds to the center pixel. If offset is 0, the last entry of the kernel is aligned with the pixel 
being output If offset is kernelsize/ 2, the kernel is centered. If offset is kernelsize, the first entry of the 
kernel is aligned with the pixel being output 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a /usr/pixar/host/lib/libchad.a /usr/pixar/host/lib/1 ibpixar.a 
SEE ALSO 

PirlConvolve3x3(3H), PWConv(3C) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User s Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlConvolve3x3, 

PirlConvolve3x3s - convolve pixel window with a 3x3 kernel 

SYNOPSIS 

#include '7usr/pixar/include/pirl.h M 
PirlError 

PirlConvolve3x3(pw, kernel) 

ChadPC *pw; 
double kernel[3][3]; 

PirlError 

PirlConvolve3x3s( pw, xkernel, ykernel ) 

ChadPW *pw; 

double xkernel[3], ykernel[3]; 

DESCRIPTION 

PirlConvolve3x3 convolves an image stored in the pixel window with the 3x3 matrix pointed to by kernel. 
The result is stored in the same pixel window. 

PirlConvolve3x3s convolves an image with a separable 3x3 matrix. The image is first convolved horizon¬ 
tally with the 3-vector xkernel and then vertically with the 3-vector ykernel. This is done in one pass. 

Where the kernel extends beyond the edge of the image, the pixel values are set to 0. 

The inner loop of PirlConvolve3x3 takes 14 ticks per pixel; the inner loop of PirlConvolve3x3s takes 19 
ticks per pixel. 

LIBRARIES 

/usr/pixar/host/Iib/libpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

PirlConvolve(3H), PWc33(3C), PWc33s(3C) 

The Chad Tutorial , and also the Chap Programming Tutorial in The Pixar User’s Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 


Release 1.2 


November 11,1986 


1 



PIRLCOPY (3H) 


Pixar Programmer’s Manual 


PIRLCOPY (3H) 


NAME 

PirlCopy - copy the source pixel window to the destination pixel window 

PirlCopyGeneric - PirlCopy with user-specified axes, start and direction parameters 

SYNOPSIS 

#include "/usr/pixar/include/pirl.h" 

PirlError 

PirlCopy (srcpw,dstpw) 

ChadPW *srcpw; 

ChadPW *dstpw; 

PirlError 

PirlCopyGeneric (srcpw,dstpw,srcRtn,srcStart,srcInc,srcAxis, 
dstRtn,dstStart,dstInc,dstAxis,spad) 

ChadPW *srcpw; 

ChadPW *dstpw; 

int srcRtn,srcStart,srcInc,src Axis,dstRtn,dstStart,dstInc,dst Axis; 

ChadSpad *spad; 

DESCRIPTION 

PirlCopy copies the source pixel window to the destination pixel window. If the pixel windows overlap, 
the source window will be overwritten. 

PirlCopyGeneric copies the source pixel window to the destination pixel window. This routine allows the 
user to specify several options for greater control of the copying operation. The srcRtn (a Chap routine) is 
used to extract a scanline from the framebuffer into spad. The srcStart and srclnc parameters specify the 
starting line, relative to the start of the source pixel window, and the increment (usually 1 or -1) in the 
direction of srcAxis (0 for x direction, 1 for y direction). Similarly, the dstRtn is used to copy the spad 
buffer into the framebuffer. dstStart, dstlnc , dstAxis have the same semantics as their source counterparts. 

The spad buffer must be large enough to hold the maximum number of pixels copied from the framebuffer 
by srcRtn. 

For programming examples, see the source for PirlCopy and PirlReflect. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

PWCopy(3C), FSCopy(3C), SFCopy(3C), PirlSwap(3H) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User’s Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Both pixel windows must be the same size and belong to the same Chap. 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 

Both axis specifiers in PirlCopyGeneric must be the same (either 0 or 1). 
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NAME 

PirlCrc - performs a Cyclic Redundency Check (CRC) on a pixel window 

SYNOPSIS 

#include <chad.h> 

#include <pirl.h> 

PirlError 

PirlCrc (pw,CrcVals) 

ChadPW *pw; 

RGBAPixelType *CrcVals; 

DESCRIPTION 

PirlCrcO computes a CCITT standard CRC value for pw. The Crc values for each channel are returned in 
CrcVals. 

LIBRARY 

libpirl.a 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/Iibchad.a/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

SSCrc(3C), PWCrc(3H), crc(lH) 

The Chad tutorial Introduction to Chad, and also the Programming Tutorial in The Pixar Programmer’s 
Manual, discuss allocation of pixel windows. 

ERRORS 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlDisplay - Display a pixel window on the monitor 

SYNOPSIS 

# include "/usr/pixar/include/pirl.h" 

extern PirlTB ThePirlTB; 

PirlError PirlDisplay(pxlwdw, xoffset, yoffset) 

PirlPW *pxlwdw; 
int xoffset, yoffset; 

DESCRIPTION 

PirlDisplay 0 sets the video board of a Pixar Image Computer to display the given pixel window on the 
monitor. Specifically, the upper left comer of the display displays the upper left comer of the pixel win¬ 
dow. If xoffset and yoffset differ from 0, then they give the location of a pixel in the pixel window which is 
displayed at the upper left. Positive offsets are rightward and down, respectively. 

The zoom rate (replication factor for the video scanout) of the display is unaffected by PirlDisplay (), but 
can be changed by PirlZoom (3H). 

The offsets needn’t lie within the pixel window, and they can be negative. However, the pixel specified 
must lie within the tile block in which the pixel window is defined. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 

SOURCE 

/usr/pixar/host/src/lib/libpirl/begin.c ~ source for PirlDisplayO 
SEE ALSO 

libpirl(3H), PirlZoom(3H) 

The Pirl Tutorial, in The Pixar Programmer’s Manual, serves as an introduction to Pixar programming 
using Pirl. 
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NAME 

PirlErrReport - print a descriptive error message explaining the last error 

SYNOPSIS 

PirlErrReport(fp) 

FILE *fp; 

DESCRIPTION 

PirlErrReport prints a descriptive error message to the file specified by fp (usually stderr). It uses the vari¬ 
able PirlLastErr, set by the CHECK macro. Since Pirl error messages are a superset of Chad error mes¬ 
sages, this routine will call ChadErrReport for the descriptive messages if the last error was within Chad. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a /usr/pixar/host/lib/libpixar.a 
SEE ALSO 

ChadErrReport, pirl.h (source for CHECK macro) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User’s Manual, 
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NAME 

PirlGetFrame, 

PirlPutFrame - get/put a buffer into a pixel window 

SYNOPSIS 

#include "/usr/pixar/include/pirl.h" 

PirlError 

PirlGetFrame ( frame, buffer, xmin, xmax, ymin, ymax ) 

ChadFrame *frame; 

RGBAPixelType *buffer; 
int xmin, xmax, ymin, ymax; 

PirlError 

PirlPutFrame ( frame, buffer, xmin, xmax, ymin, ymax ) 

ChadFrame *frame; 

RGBAPixelType *buffer; 
int xmin, xmax, ymin, ymax; 

DESCRIPTION 

PirlGetFrame copies an array of pixels from the pixel window associated with frame to the buffer. Pirl¬ 
PutFrame copies an array of pixels from a buffer to a pixel window associated with frame. In both cases 
the buffer is assumed to contain (xmax-xmin+1) times (ymax-ymin+Y) RGB A pixel values. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 

SEE ALSO 

ChadFrame(3H) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User’s Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlGetBuf, 

PirlPutBuf - Get/put a block of pixels from/to a pixel window 

SYNOPSIS 

# include M /usr/pixar/include/pirl.h H 

# include "/usr/pixar/include/pixeldef.h” 

PirlError PirlGetBuf ( pw, pxlbuf, xmin, xmax, ymin, ymax ) 

PirlError PirlPutBuf ( pw, pxlbuf, xmin, xmax, ymin, ymax ) 

PirlPW pw; 

RGBAPixelType *pxlbuf; 
int xmin, xmax, ymin, ymax; 

DESCRIPTION 

PirlGetBuf 0 reads a rectilinear subwindow of pixels from a pixel window into a hostside buffer. Pirl- 
SaveBuf 0 does the opposite, pw is the Pirl default pixel window ThePirlPW, or any other pixel window 
as allocated by PirlNewPW 0- xmin, xmax, ymin and ymax describe the set of pixels involved, so that 
(xmax-xmin+l) * (ymax-ymin+l) pixels are read/written. The buffer pxlbuf must have at least this many 
pixels in it, in row-major order (the first row of pixels, followed by the second, etc.). 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a /usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 
SOURCE 

/usr/pixar/host/src/lib/libpirl/buf.c - source for PirlGetBufO and 
PirlPutBufO. 

SEE ALSO 

libpirl(3H), PirlBegin(3H), PirlNewPW(3H) 

PirlGetPic (3H) discusses how to save (and restore) whole pixel windows to (and from) disk files. 

The Pirl Tutorial, in The Pixar Programmer’s Manual, serves as an introduction to Pixar programming 
using Pirl. 
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NAME 

PirlGetPic, 

PirlSavePic - Get/save a pixel from/to a disk file 

SYNOPSIS 

# include "/usr/pixar/include/pirl.h" 

# include ’'/usr/pixar/include/picio.h" 

PirlError PirlGetPic ( pic, pw, xoff, yoff) 

PirlError PirlSavePic ( pic, pw, xoff, yoff) 

PFILE *pic; 

PirlPW pw; 
int xoff, yoff; 


DESCRIPTION 

PirlSavePic 0 saves a pixel window in a picture file. PirlGetPic 0 gets pixels from a picture file into a 
pixel window, pic is a picture file descriptor such as is opened by PicCreat (3H) or PicOpen 0- pw is the 
Pirl default pixel window ThePirlPW, or any other pixel window as allocated by PirlNewPW (). xoff and 
yoff are offsets: in the context of PirlSavePicO, the offset means that the pixel window origin (upper left 
pixel) is offset in die picture file. To PirlGetPic 0, it means that the origin of the picture as stored in the 
file is offset with respect to the pixel window origin when copying it to the frame buffer. Thus, if the two 
xoffs and yoff s sum to 0 for a Get/Save pair on the same file, the pixels appear in the same place in the pixel 
window after restoration. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a /usr/pixar/host/lib/libpicio.a /usr/pixar/host/lib/libchad.a 

/usr/pixar/host/lib/libpixar.a 

SOURCE 

/usr/pixar/host/src/lib/libpirl/getsv.c - source for PirlGetPicO and 
PirlSavePicO- 

SEE ALSO 

libpicio(3H), libpirl(3H), PirlNewPW(3H), PicCreat(3H) 

The Pirl Tutorial , in The Pixar Programmer’s Manual , serves as an introduction to Pixar programming 
using Pirl. 
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NAME 

PirlGetRaster - get a raster image file into a pixel window 

SYNOPSIS 

#include "/usr/pixar/include/pirl.h" 

PirlError 

PirlGetRaster ( pw, fd, mode, shift, swap ) 

ChadPW *pw; 

int fd, mode, shift, swap; 

DESCRIPTION 

PirlGetRaster copies an array of pixels from the file whose file descriptor is j fd into pixel window pw. If 
the flag shift is non-zero, each channel value will be multiplied by eight (this is useful for 8-bit per channel 
pictures.) If the flag swap is non-zero, the bytes in each channel word will be swapped (for 16-bit per chan¬ 
nel pictures only.) The type of picture to be copied is controlled by mode, as follows: 


BW8 - black and white image 8 bits-per-channel 

BWI6 - black and white image 16 bits-per-channel 

RGB8 - RGB image 8 bits-per-channel 

RGB16 - RGB image 16 bits-per-channel 

RGB A8 - RGB A image 8 bits-per-channel 

RGBA16 - RGB A image 16 bits-per-channel 


For black and white images, IFxCopy is called, and for color images, 
SFxCopy is called. 


LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

see(l), SFCopy(3C), IFCopy(3C) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User’s Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlHistogram - accumulate frequency histogram of a pixel window 

SYNOPSIS 

#include "/usr/pixar/include/pirl.h" 

PirlError 

PirlHistogram (pw, histogram, size, component) 

ChadPW *pw; 
int histogram []; 
register size, component; 

DESCRIPTION 

PirlHistogram accumulates a frequency histogram of one component of the pixels within a pixel window. 
The histogram table is an array of size long ints (32-bits). The routine assumes that 11-bit values are being 
examined; they are rescaled to fit into the size accumulators of the histogram array. The scaling is one- 
for-one, if size=4 096. Since pixel values are signed fixed point numbers in the range [-.5E, 1.5E), the his¬ 
togram entry for pixel value 0 is at location size!4. 

LIBRARIES 

/usr/pixar/host/libAibpirl.a/usr/pixar/host/lib/libchad.a/usr/pixarAiost/lib/libpixar.a 

SEE ALSO 

PirlRange(3H) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User’s Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlBeginLines, 

PirlEndLines, 

PirlPolyLine, 

PirlSetLine Attributes, 

PirlSetLineColor, 

PirlSetLineEdge, 

PirlSetLineMode, 

PirlSetLineWidth - Draw lines in a pixel window and set line characteristics 

SYNOPSIS 

#include "/usr/pixar/include/pirl.h" 

PirlError 

PirlBeginLines() 

PirlError 

PirfEndLines() 

PirlError 

PirlPolyLine(pw,n,xy) 

ChadPW *pw; 
int n; 

float xy[/z][2]]; 

PirlError 

PirlSetLineAttributes(name,linewidth,linemode,color, 

edgetype,edgewidth,edgefunctionptr, 

fiItertype,filterwidth,filterfunctionptr) 

char *name; 
float line width; 

PirlLineMode linemode; 

RGBAPixelType color; 

PirlEdgeType edgetype; 
float edgewidth; 
float *edgefunctionptr; 

PirlFilterType filtertype; 
float filterwidth; 
float *fi!terfunctionptr; 

PirlError 

PirlSetLineCoIor(color) 

RGBAPixelType color; 

PirlError 

PirlSetLineEdge(name) 
char *name; 

PirlError 

PirlSetLineMode(mode) 

PirlLineMode mode; 

PirlError 

PirlSetLine Width(width); 
float width; 
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DESCRIPTION 

PirlBeginLines initializes all settable line attributes (e.g., line width, line mode, color, line edge characteris¬ 
tics, and antialiasing filter), to their default values and begins a state where line edge description tables are 
permanently loaded into the scratchpad of the Chap currently being used by Pirl. If PirlBeginLines is not 
called, then the current edge description table will be temporarily loaded into the scratchpad each time Pirl- 
PolyLine is called, and the scratchpad space freed after the PirlPolyLine call. The default values for the 
line attributes are color = RGBA = 2048, line mode = PM_MERGE, line width = 1 pixel, line edge type = 
PE_HARD with width 1 pixel, line filter type = PF_BOX with filter width = 1 pixel. 

PirlEndLines causes all permanently allocated scratchpad resources to be freed. All calls to PirlPolyLine 
after a call to PirlEndLines will cause the current edge description table to be temporarily loaded into the 
scratchpad only for the duration of the PirlPolyLine call. 

PirlPolyLine is called to draw n connected lines within the specified pixel window pw. The lines are drawn 
with the current line attributes (i.e., color, line mode, and line width), set by previous calls to PirlSet- 
LineColor, PirlSetLineMode, and PirlSetLineWidth. The endpoints of the lines are expressed as floating 
point number pairs within the specified pixel window (e.g., x=0.0 to 1023.75, y=0.0 to 783.75). Lines will 
be drawn to quarter pixel resolution by PirlPolyLine. 

PirlSetLineAttributes specifies all line attributes that may subequently be referred to by name. PirlSet- 
LineAttributes merely establishes an attribute set that may be subsequently be passed to PirlSetLineEdge to 
cause the line attributes to have effect for subsequently drawn lines. Parameters passed to PirlSetLineAttri¬ 
butes include all the setable line attributes (color, line mode, and line width) plus parameters that are used 
to create an edge description table in the scratchpad of the current Chap with the edge characteristics 
specified by edge, edgewidth, and edgefunctionptr and with antialiasing performed using a filter that is 
specified by filter, filterwidth, and filterfunctionptr . 

edge may be one of the following: 

PE_GIVEN 

PEJHLARD 

PE_RANDOM 

PE_FELTTIP 

The edge function is the profile of the edge used to determine the line’s contribution to neighborhood pix¬ 
els. The edge is represented by a table of alpha values as a function of distance to the line. The line is 
drawn by finding the distance from each pixel to the line segment, using the edge table to find the alpha, 
using the alpha in the classic expression (B + a*(F-B)), where F is the color of the line being drawn and B 
is the color of the background at the pixel. The edge function is convolved with a filter function to create 
an edge profile table. Lines are drawn subject to this edge profile table that determines the rolloff at the 
edges. Those edges occur width pixels away from the line center (and along semicircles at the endpoints). 
A line with a hard edge will appear as twice this width. 

Predefined edge functions include PE_HARD, PE_RANDOM, and PE_FELTTIP. A PE_HARD edge falls 
shrply from 1.0 to 0.0. A PE_RANDOM edge jumps randomly between 1.0 and 0.0 throughout its width. 
A PEJFELTTIP edge is a gaussian function throughout its width. A PE_GIVEN edge is provided as a 
table pointed to by edgefunctionptr. The table records the rolloff starting near 1.0 and falling gradually to 
0.0 with edgewidth entries. 

filter may be one of the following: 

PF_GIVEN 

PF_SINC 

PF.NONE 

PF_BOX 

Each of these is a convolution filter used to smooth out the edge function. Predefined filter functions 
include PF_SINC, PF_NONE, and PF_BOX. The PF_NONE alternative is provided to demonstrate the 
effects of improper anti-aliasing; it is not recommended. The PF_SINC function is the windowed sine 
function (sinc(x)*sinc(x/2)). The extent of the filter filterwidth is measured in pixels and the recommended 
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filter width is 1. For PF_SINC, this is the distance between the center of the function and its first zero. A 
PF_GIVEN filter is provided in a table pointed to by filterfunctionptr. All 2 * filterwidth +1 values of the 
function should be provided, scaled between 0 and 1. 

The edge description table will be created in the scratchpad of the current Chap by PirlPolyLine tem¬ 
porarily if PirlBeginLines has not been called, otherwise it will create the edge decription table in the 
scratchpad allowing the table to remain allocated for subsequent use. All allocated scratchpad resources 
will be freed by a call to PirlEndLines. 

Calls to PirlSetLineAttributes with PE_GIVEN or PF_GIVEN require that a function be provided by the 
calling procedure that specify user-supplied edge and filter tables. The edgefunctionptr is not referenced 
unless PE_GIVEN is specified. The filterfunctionptr is not referenced unless PF_GIVEN is specified. 

PirlSetLineColor sets the current color for which all subsequent lines will be drawn by PirlPolyLine until 
another color is specified in a call to PirlSetLineColor or PirlSetLineAttributes. 

PirlSetLineEdge sets the line attributes and edge characteristics for all subsequent lines drawn by PirlPoly- 
line. The edge specified in the PirlSetLineEdge call must previously have been specified by a call to Pirl¬ 
SetLineAttributes. 

PirlSetLineMode set the current mode for which all subsequent lines will be drawn by PirlPolyLine. Valid 
modes that may be specified are: 

PM_REPLACE 

PM_MERGE 

PM_MAX 

A default mode of PF_REPLACE will be used by PirlPolyLine if one has not been specified by a call to 
PirlSetLineMode. 

PirlSetLineWidth set the current line width for all subsequent lines will be drawn by PirlPolyLine. The line 
width is expressed as a floating point number that will be interpreted to quarter pixel resolution by PirlPoly¬ 
Line (e.g., line width = .25 to 255.75). 

LIBRARIES 

/usr/pixar/host/libAibpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 

SEE ALSO 

The Chad Tutorial , and also the Chap Programming Tutorial in The Pixar User’s Manual , discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 

BUGS 

Other edge types and filter types may be specified, but may produce unpredictable and undesirable results. 
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NAME 

PirlMakeMap - Create a map for changing the colors of a pixel window 

Mapfcn - Mapping function for PirlMakeMap 

SYNOPSIS 

#include <pixeldefs.h> 

#include ”/usr/pixar/include/pirLh’' 

PirlError 

PirlMakeMap(map, non-neg, clamped, mapfcn) 

RGBAPixelType map[]; 
int non-neg, clamped; 
int (*mapfcn)(); 

int mapfcn(val, pxl) 
double val, pxl[4]; 

DESCRIPTION 

PirlMakeMapO expresses a functional mapping between 12-bit Pixar pixel values as a table (map) 
indexed by these bits of those pixels. It must be given the table, a pointer to a function mapfcn mapping 
from the range [-.5,1.5). The map parameter has either 2048, 3072 or 4096 four-value elements, depending 
on the parameters non-neg and clamped : non-neg indicates that the map is to exclude negative pixel values, 
thus is 1024 entries smaller, clamped indicates that the map excludes values greater than 1, so is 1023 
entries smaller. These flags are meant to be passed also to the function PirlMap (3H), which applies the 
map to a pixel window in Pixar image memory. 

LIBRARIES 

/usr/pixar/host/libAibpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 

SEE ALSO 

PirlMap (3H) 

The Chad Tutorial , and also the Chap Programming Tutorial in The Pixar User s Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

It is a serious, undiagnosable error for the table passed to be too small for the state of clamped and 
non_neg. 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlMap - remap 4 components of a pixel window 

SYNOPSIS 

#include "/usr/pixar/include/pirl.h" 

#include <pixeldeft.h> 

PirlError 

PirlMap(pw, map, non_neg, clamped) 

ChadPW *pw; 

RGBAPixelType map[]; 
int non_neg, clamped; 

DESCRIPTION 

PirlMap changes the color values of a pixel window according to a function expressed as a map between 
pixel values in and pixel values out. Since pixel values are twelve bits wide, the map will normally contain 
4096 four-channel elements. If the pixel values are all non-negative, a non-zero non neg value will indi¬ 
cate that the map covers only those values, and is 1024 elements smaller as a result. Likewise, for pixels 
all less than or equal to 1.0, the clamped flag changes the assumed table size by 1023 elements. The princi¬ 
ple benefit of these assumptions is minimizing the size of the table which must be loaded into the Chap’s 
scratchpad. The function PirlMakeMap( 3H) will construct the map table. 

The mapping defined by the table gives each output channel value strictly as a function of that channel. 
Output in which a channel depends on the other channels in the pixel may be produced using PirlCha(3K). 

LIBRARIES 

/usr/pixar/host/libAibpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

PirlMapComp(3H), PirlMakeMap(3H), PirlCha(3H) 

PW4Map(3C), PWMap(3C) 

The Chad Tutorial , and also the Chap Programming Tutorial in The Pixar User's Manual , discuss alloca¬ 
tion of pixel windows. 

ERRORS 

PirlMap is most likely to fail due to the scratchpad being full. It is also a serious, undiagnosable error for 
the table as passed to be too small for the state of clamped and nonjieg. 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlMapComp - map a single component through a color table to form a color image 

SYNOPSIS 

PirlMapComp(pwsrc, channel, table, tablesize) 

ChadPW *pwsrc; 

RGBAPixelType map[]; 
int channel, tablesize; 

DESCRIPTION 

PirlMapComp creates a color image from a single channel image by using the value in the single channel 
image as in index into a color table. The given component, channel , which must be a number from 0 to 3 
(representing red through alpha) of the image stored in the source pixel window, pwsrc, are mapped and 
written back to the same window. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

PirlMap(3H), PirlMakeMap(3H), PirlCha(3H) 

SS4Map(3C), PWMap(3C) 

SSRtoRGBALUT(3C), SSGtoRGBALUT(3C), SSBtoRGBALUT(3C), SSAtoRGBALUT(3C) 
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NAME 

PirlMerge - composite a foreground with a background 

SYNOPSIS 

#include "/usr/pixar/include/merge.h" 

#include "/usr/pixar/include/pirl.h" 

PirlError 

PirlMerge (fgd, bkg, dst, op, Lf, Lb) 

ChadPW *fgd, *bkg, *dst; 

MergeOp op; 

RGBAPixelType *Lf, *Lb; 

DESCRIPTION 

PirlMerge implements the Porter-Duff compositing algegra on a pair of pixel windows, given by fgd and 
bkg, writing the composited pixels into dst (the dimensions of the three pixel windows must be identical, 
but the pixel windows themselves need not be distinct). 

The paper “Compositing Digital Images,’’ in SIGGRAPH '84, discusses the semantics of the merging 
operators. Briefly, compositing is performed by combining images using the fourth (alpha) channel in the 
image as a matte giving the opacity of image at each pixel. The assumption is that the interesting informa¬ 
tion in an image is confined to pixels with non-zero opacity, so that the matte may be used to allow back¬ 
grounds to show through, in proportion to the value of alpha. 

The operator, given by op, is one of the following tokens defined in <merge.h>: 

MergeOpCLEAR — Clear the destination window 
MergeOpCOPY - Copy the foreground 
MergeOpNOOP - Copy the background 
MergeOpOYER (“merge foreground over background”) 

- Copy both foreground and background, copying foreground where they intersect. 

MergeOpUNDER (“merge foreground under background”) 

-- Copy both foreground and background, copying background where they intersect. 

MergeOpOUT (“use foreground held out by background”) 

- Copy those parts of the foreground which lie outside the background 
MergeOpIN (“use background held out by foreground”) 

-- Copy those parts of the background which intersect the foreground 
MergeOp ABOVE (‘‘copy foreground above background”) 

— Like in, but also copies background pixels lying outside the foreground 
MergeOpBELOW (“copy background above foreground”) - opposite of above 
MergeOpXOR (“foreground or background, but not both”) 

-- Copies foreground and background, except where they intersect. 

MergeOpPLUS (“add pixels”) -- Sums the pixel values. 

MergeOpPLUSIN (“sum pixels in intersection”) 

— Takes the sum of the two images, writing the result where the background appears. 
MergeOpPLUSBELOW (“sum pixels above background”) 

- Mix pixels where foreground and background intersect; 
copy background elsewhere 

MergeOpPLUS ABOVE (“sum pixels above foreground”) 

~ Mix pixels where foreground and background intersect; copy foreground elsewhere 

The pixel structures Lf and Lb give attenuation factors for the channels of the foreground and background 
images, respectively. They should be pixel values in the interval [-.5,1.5). Pixel values in this range may 
be obtained from floating-point values in the same range with the macro DBL2PXL. 
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SEE ALSO 

Compositing Digital Images {Pixar Programmer’s Manual) - the above paper, excerpted. 
merge(l) 

The Chad Tutorial , and also the Chap Programming Tutorial in The Pixar User's Manual, discuss alloca¬ 
tion of pixel windows. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 

ERRORS 

PirlMerge will fail if it cannot allocate sufficient scratchpad memory for storing two full scan lines, or if 
there is no room in instruction memory for the Chap routines it uses. It also fails if the pixel windows it is 
given do not match in x and y dimensions. 

BUGS 

As discussed in the paper, this style of compositing is susceptible to failure on correlated data, for example 
when two images depict objects with adjacent edges. 
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NAME 

PirlNewPW — Make a new pixel window under Pirl 

SYNOPSIS 

# include "/usr/pixar/include/pirl.h" 

PirlError PirlNewPW(pwp, xmin, xmax, ymin, ymax) 

PirlPW *pwp; 

int xmin, xmax, ymin, ymax; 

DESCRIPTION 

PirlNewPWO allocates a new pixel window under Pirl of the given dimensions. It returns a PirlError 
value, which should be checked for a nonzero (i.e., error) value. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 

SOURCE 

/usr/pixar/host/src/lib/libpirl/begin.c - source for PirlBeginO and 
PirlEnd 0 

SEE ALSO 

libpirl(3H), PirlBegin(3H) 

The Pirl Tutorial , in The Pixar Programmer’s Manual, serves as an introduction to Pixar programming 
using Pirl. 
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NAME 

PirlNot - subtract pixel value from 1.0 (0x800) for a pixel window 

SYNOPSIS 

#include "/usr/pixar/include/pirl.h" 

PirlError 
PirlNot (pw) 

ChadPW *pw; 

DESCRIPTION 

PirlNot subtracts the pixel value from 1.0 (0x800) for each pixel in the pixel window. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 

SEE ALSO 

PWNot(3C) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User’s Manual , discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlRampX, 

PirlRampY - draw a ramp into a pixel window 

SYNOPSIS 

#include "/usr/pixar/include/pirl.h" 

PirlError 

PirlRampX (pw, left, right) 

ChadPW *pw; 

RGBAPixelType *left, *right; 

PirlError 

PirlRampY (pw, top, bottom) 

ChadPW *pw; 

RGBAPixelType *top, ^bottom; 

DESCRIPTION 

PirlRampX draws a ramp in which the pixels in a column are identical, and the pixels in a row are linearly 
interpolated between pixel values l and r. PirlRampY performs the converse operation. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a /usr/pixar/host/lib/libchad.a /usr/pixar/host/lib/libpixar.a 
SEE ALSO 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User’s Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlRange - find the minimum and maximum pixel values in a pixel window 

SYNOPSIS 

#include "/usr/pixar/include/pirl.h” 

PirlError 

PirlRange (pw, min, max) 

ChadPW *pw; 

RGBAPixelType *min, *max; 

DESCRIPTION 

PirlRange finds the minimum and maximum values of each component within a pixel window. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

PWRange(3C) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User’s Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlReflectX - reflect the pixel window around its center horizontal axis 

PirlReflectY - reflect the pixel window around its center vertical axis 

SYNOPSIS 

#include "/usr/pixar/include/pirl.h" 

PirlError 

PirlReflectX (pw) 

ChadPW *pw; 

PirlError 

PirlReflectY (pw) 

ChadPW *pw; 

DESCRIPTION 

PirlReflectX turns a pixel window upside-down by reflecting it around its horizontal axis. 

PirlReflectY mirrors a pixel window left-right by reflecting it around its vertical axis. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a /usr/pixar/host/libAibchad.a/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

PirlCopyGeneric(3H), perm(l) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User’s Manual , discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlResize - copy the source pixel window to the destination pixel window 

SYNOPSIS 

#include H /usr/pixar/include/pirl.h M 
PirlError 

PirlResize(srcpw,dstpw,hextent,vextent) 

ChadPW *srcpw; 

ChadPW *dstpw; 

int hextent,vextent; 

DESCRIPTION 

PirlResize resizes the source pixel window to the destination pixel window. The two pixel windows must 
not overlap. 

The hextent and vextent are the filter widths for horizontal and vertical scaling. An extent of four, a cubic 
filter, produces produces the best resized images, at the cost of using more intermediate scratchpad memory 
and more time. An extent of two, a linear filter, produces an acceptable resizing, but some image quality is 
lost. 

Different horizontal and vertical filter widths may be specified. 

For programming examples, see the source for resize shell command. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a /usr/pixar/host/lib/libpixar.a 

SEE ALSO 

PWResize(3C) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User’s Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Both pixel windows must belong to the same chap. The two pixels window must not overlap. 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlRotate - rotate a pixel window 

SYNOPSIS 

#include <chad.h> 

#include <pirl.h> 

PirlError 

PirlRotate(srcpw, tmppw, dstpw, angle, sx, sy, cx, cy,clr,extent) 

ChadPW *srcpw,*tmppw,*dstpw; 
double angle,sx,sy,cx,cy; 
int clr,extent; 

DESCRIPTION 

PirlRotate rotates, scales,and translates a source pixel window to a destination pixel window. The transfor¬ 
mation is performed using a two-pass (horizontal and vertical) resampling algorithm. 

Source and destination pixel windows are specifed for each pass of the resampling algorithm. The source 
and destination pixel windows for each pass cannot partially overlap, srcpw defines the transformation 
source pixel window, tmppw defines the destination window for the first (intermediate) pass and the 
source for the second pass, dstpw defines the the destination for the second (final) pass. If the dstpw is 
smaller than the srcpw, the tmppw must be greater than or equal to the size of the srcpw. The transforma¬ 
tion can be done in place, so srcpw, tmppw, and dstpw can all point to the same pixel window. 

angle specifies the number of degrees to rotate. 

sx, sy specifies the scale factors for the horizontal and vertical dimensions, 
cx, cy specifies the center of rotation. 

clr is a flag wich specifies whether rotate should clear out its borders. 

extent specifies the filter width (in pixels). An extent of four will use a cubic filter. An extent of two will 
use a linear filter. 

FILES 

/usr/pixar/host/src/lib/libpirl/affine.c 

LIBRARIES 

/usr/pixar/host/libAibpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

Rotate(l), PirlAffine(3h), PirlShear(3h), PWShear(3c) 
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NAME 

PirlSetChannelMask - set a pixel window’s channel mask 
SYNOPSIS 

#include "/usr/pixar/include/pirl.h” 

PirlError 

PirlSetChannelMask (pw,mask) 

ChadPW *pw; 
int mask; 

DESCRIPTION 

PirlSetChannelMaskQ sets the channel mask for the pixel window for future writing. The mask is a 
number between 0 (all channels off) and Oxf (all channels on). The channel mask is formed by OR-ing the 
following mask bits: 
red - Oxl 
green - 0x2 
blue -0x4 
alpha - 0x8 

LIBRARIES 

/usr/pixar/host/Iib/libpirl.a /usr/pixar/host/lib/libchad.a /usr/pixar/host/lib/libpixar.a 

SEE ALSO 

SetMaskPW 

The Chad Tutorial , and also the Chap Programming Tutorial in The Pixar User’s Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlShear - Shear a pixel window 

SYNOPSIS 

#include <chad.h> 

#include <pirl.h> 

PirlError 

PirlShear(srcpw,dstpw,scale,off,inc,access,clr,extent,iw,ih) 

ChadPW *srcpw,*dstpw; 
double scale,off,inc; 
int access,clr,extent,iw,ih; 

DESCRIPTION” 

PirlShear shears a source pixel window and places the result in a destination pixel window. 

srcpw defines the source pixel window to shear. 

dstpw defines the the destination pixel window. 

scale specifies a scale factor for resizing each scanline 

off specifes the offset for the first destination scanline. 

inc specifes the incremental offset for each additional destination scanline. 

access specifies the scanline access directions for the src and dst. 

access must be one of the following defined options: 


#define XIN_XOUT 0 

#define XBACKWARDSIN_XOUT 1 

#define YIN_XOUT 2 

#define YBACKWARDSEN_XOUT 3 

#define YIN_YOUT 4 

#define YBACKWARDSIN_YOUT 5 

#define XIN_YOUT 6 

#define XBACKWARDSIN_YOUT 7 


clr is a flag wich specifies whether shear should clear out its borders. 

extent specifies the filter width (in pixels). An extent of four will use a cubic filter. An extent of two will 
use a linear filter. 

iw,ih specify the input width and height of the src window. 

FILES 

/usr/pixar/host/src/lib/libpirl/affine.c 
SEE ALSO 

Rotate(l), PirlRotate(3h), PirlAffine(3h), PWShear(3c) 


Release 1.2 
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NAME 

PirlShift - shift pixel window contents in x and/or y 

PirlCircularShift - circular shift pixel window contents in x and/or y 

SYNOPSIS 

#include M /usr/pixar/incIude/pirl.h H 

PirlError 

PirlShift(pwpc,y) 

ChadPW *pw; 
int x,y; 

PirlError 

PirlCircularShift(pw,x,y) 

ChadPW *pw; 
int x,y; 

DESCRIPTION 

PirlShift shifts the contents of a pixel window in x and/or y. The pixels shifted outside the pixel window 
are clipped. The original pixels are retained in the exposed area. X and Y may be positive or negative. 

PirlCircularShift shifts the contents of a pixel window in x and/or y. The pixels shifted outside the pixel 
window are circularly shifted around the edge of the pixel window into the exposed area. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a /usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

PWShift(3C), perm(l) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User’s Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlShuffle - shuffle components of each pixel for a pixel window. 

SYNOPSIS 

#include "/usr/pixar/include/pirl.h” 

PirlError 

PirlShuffle (pw,perm) 

ChadPW *pw; 
char perm [4]; 

DESCRIPTION 

PirlShuffle shuffles the contents of the pixel window using the string perm. This string forms a general pur¬ 
pose crossbar for shuffling of pixel components. For instance, the string “rrrr” places the red component 
of each pixel into all four components, “grba” exchanges the red and green components. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

PWShuffle(3C), perm(l) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User’s Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

The permutation string must be four characters of [rgbaRGBA]. 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlSwap - swap the source pixel window and the destination pixel window 

SYNOPSIS 

#include " /usr/pixar/include/pirl.h'' 

PirlError 

PirlSwap (srcpw,dstpw) 

ChadPW *srcpw; 

ChadPW *dstpw; 

DESCRIPTION 

PirlSwap swaps the source pixel window and the destination pixel window. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

PWSwap(3C), FSCopy(3C), SFCopy(3C) 

The Chad Tutorial , and also the Chap Programming Tutorial in The Pixar User’s Manual , discuss alloca¬ 
tion of pixel windows. 

ERRORS 

Both pixel windows must be the same size, not overlap, and belong to the same Chap. 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlSweepX, 

PirlSweepY - copy one scanline repeatedly into a pixel window 

SYNOPSIS 

#include "/usr/pixar/include/pirLh” 

PirlError 

PirlSweepX ( pw, line ) 

ChadPW *pw; 

RGBAPixelType line[ ]; 

PirlError 

PirlSweepY ( pw, line ) 

ChadPW *pw; 

RGBAPixelType line[ ]; 

DESCRIPTION 

PirlSweepX and PirlSweepY copy a single line of pixels into a pixel window. PirlSweepX copies the line to 
every row in the pixel window. PirlSweepY copies the line to every column in the pixel window. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/libAibpixar.a 

SEE ALSO 

PirlClear(3H) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User s Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

The line buffer of pixel values must be of appropriate size. These routines cannot confirm this. They may 
also fail if insufficient resources are available on the Chap. 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlTranspose - transpose a pixel window around the diagonal axis. 

SYNOPSIS 

#include ’’/usr/pixar/include/pirl.h" 

PirlError 

PirlTranspose (pw) 

ChadPW *pw; 

DESCRIPTION 

PirlTranspose 0 transposes a pixel window around its diagonal axis (0,0) to (N,N). Any orientation of the 
pixel window may be achieved by a combination of transpositions and reflections. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a /usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

PWTranspose(3C), PirlReflect(3H), perm(l) 

The Chad Tutorial, and also the Chap Programming Tutorial in The Pixar User’s Manual, discuss alloca¬ 
tion of pixel windows. 

ERRORS 

The pixel window must be square or the token PIRL_NOT_SQUARE is returned. 

Since this function allocates resources on the Chap that owns the pixel window, all Chad errors apply. 
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NAME 

PirlZoom - Zoom in on a pixel window on the monitor 

SYNOPSIS 

# include "/usr/pixar/include/pirl.h" 

PirlError PirlZoom(zoomrate) 
int zoomrate; 

DESCRIPTION 

PirlZoom 0 sets the video board of a Pixar Image Computer to duplicate pixels between the frame buffer 
and the display, in effect making the pixels larger by a factor given by zoomrate. 

The top left pixel of the display is the base for the zoom; after zooming up, pixels will appear shifted to the 
right and down in proportion to their distance from the upper left 

The pixel in the frame buffer which is seen at upper left in the display is set by PirlDisplay (3H). 
zoomrate must lie in the range [0..15]. 

LIBRARIES 

/usr/pixar/host/lib/libpirl.a/usr/pixar/host/lib/libchad.a/usr/pixar/host/lib/libpixar.a 

SOURCE 

/usr/pixar/host/src/lib/libpirl/begin.c - source for PirlZoomO 
SEE ALSO 

libpirl(3H), PirlDisplay(3H) 

The Pirl Tutorial, in The Pixar Programmer's Manual , serves as an introduction to Pixar programming 
using Pirl. 
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NAME 

libpixar - introduction to Host-resident Pixar library functions 

DESCRIPTION 

libpixar is a library of C-callable functions which provide a low-level interface to the Pixar. Much of this 
functionality has been absorbed into Chad, a simplified library for executing programs on the Pixar’s Chan¬ 
nel Processor. 

This section describes functions used by programs executing on the host. The functions described in this 
section are found in the library libpixar. 

FILES 

/usr/pixar/lib/libpixar.a low-level Pixar functions 
/usr/pixar/lib/libpixar_p.a profiled versions of libpixar.a functions 


SEE ALSO 

Programming the Pixar with Chad , in the Pixar Programmer’s Manual , 

video(l), mctrl(8), Chap*(3H), dumiopen(3H), video*(3H), mctrlopen(3H), dbopen(3H), dumi(4), 
Chap(4), video(4), mctrl(4) 


intro(l) 

intro(3C) 

intro(3H) 

libchad(3H) 


- list of shell-callable Pixar programs 

- list of libraries of device-resident routines 

- list of libraries of host-resident routines 

- library of high-level Chap interface routines 


LIST OF FUNCTIONS 


Name 

Appears on Page 

ChapAfillSpad 

Chapspad(3H) 

ChapAllocFB 

Chapmman(3H) 

ChapAllocRam 

Chapmman(3H) 

ChapAllocSpad 

Chapmman(3H) 

ChapAppendArchives 

Chapload(3H) 

ChapBeginLoad 

Chapload(3H) 

ChapClose 

Chapopen(3H) 

ChapClrBpt 

Chapbpt(3H) 

ChapCont 

Chaprun(3H) 

ChapDumpRam 

Chapram(3H) 

ChapDumpSpad 

Chapspad(3H) 

ChapDynamicLoad 

Qiapload(3H) 

ChapDynamicUnload 

Chapload(3H) 

ChapDynamicUnloadAll 

Chapload(3H) 

ChapEndLoad 

Chapload(3H) 

ChapExecInst 

Chapinst(3H) 

ChapFillSpad 

Chapspad(3H) 

ChapFreeFB 

Chapmman(3H) 

ChapFreeRam 

Chapmman(3H) 

ChapFreeSpad 

Chapmman(3H) 

ChapGetArchives 

Chapload(3H) 

ChapGetConfig 

Chapconfig(3H) 

ChapGetFB 

Chapmman(3H) 

ChapGetMap 

Chapmman(3H) 

ChapGetRam 

Chapmman(3H) 

ChapGetSDR 

Chapreg(3H) 

ChapGetSpad 

Chapmman(3H) 

ChapHalt 

ChapRun(3H) 

ChapLoad 

Chapload(3H) 

ChapLoadFile 

Chapold(3H) 


Description 

-fill each Chap scratchpad memory with its address 

-allocate/free space in the framebuffer 

-allocate/free space in instruction ram 

-allocate/free space in scratchpad 

-manipulate dynamic loading archive list 

-begin/end a dynamic load or unload 

-open/close a Chap device 

-set and clear Chap breakpoints 

-continue the current Chap program 

-read/write multiple locations in Chap instruction memory 

-read/write multiple locations in Chap scratchpad 

-dynamically load files into a Chap 

-dynamically unload files from a Chap 

-dynamically unload files from a Chap 

-begin/end a dynamic load or unload 

-manipulate Chap diagnostic instruction register 

-fill Chap scratchpad memory with a single value 

-allocate/free space in the framebuffer 

-allocate/free space in instruction RAM 

-allocate/free space in scratchpad 

-manipulate dynamic loading archive list 

-get/set Chap configuration information 

-allocate/free space in the framebuffer 

-get allocation map from kernel 

-allocate/free space in instruction ram 

-get the value of shared data register 

-allocate/free space in scratchpad 

-halt the Chap 

-dynamically load files into a Chap 

-load a non-relocatable Chap object file [defunct] 
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ChapLoadGo 

ChapLoadlnst 

ChapLoadRam 

ChapLoadSpad 

ChapLoadSymbol 

ChapMMan 

ChapOpen 

ChapReadAbusDev 

ChapReadAcc 

ChapReadlnst 

ChapReadLc 

ChapReadMbusDev 

ChapReadPc 

ChapReadRam 

ChapReadReg 

ChapReadRunflag 

ChapReadRunflags 

ChapReadSbus 

ChapReadSbusDev 

ChapReadSpad 

ChapReadXbar 

ChapReset 

ChapResetlnterrupt 

ChapResetMap 

ChapRun 

ChapRunAsync 

ChapSetArchives 

ChapSetlnterrupt 

ChapSetBpt 

ChapSetConfig 

ChapSetSDR 

ChapSetVDR 

ChapS tep 

ChapSymEnter 

ChapSymLookup 

ChapSymX 

ChapVdregBase 

ChapWaitForlnterrupt 

CbapWriteAec 

ChapWriteLc 

ChapWriteMbusDev 

ChapWritePc 

ChapWriteRam 

ChapWriteReg 

ChapWriteRunflag 

ChapWriteRunflags 

ChapWriteSbusDev 

ChapWriteSpad 

ChapWriteXbar 

ChapXSym 

DbClose 

DbOpen 

DumiClose 
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ChapLoadGo(3H) 

Chapinst(3H) 

Chapram(3H) 

Chapspad(3H) 

Chapload(3H) 

Chapmman(3H) 

Chapopen(3H) 

Chapabus(3H) 

Chapalu(3H) 

Chapinst(3H) 

Chapstack(3H) 

Chapmbus(3H) 

Chapstack(3H) 

Chapram(3H) 

Chapalu(3H) 

Chapstack(3H) 

Chapstack(3H) 

Chapsbus(3H) 

Chapsbus(3H) 

Chapspad(3H) 

Chapxbar(3H) 

Chapreset(3H) 

Chapwait(3H) 

Chapmman(3H) 

Chaprun(3H) 

Chaprun(3H) 

Chapload(3H) 

Chapwait(3H) 

Chapbpt(3H) 

Chapconfig(3H) 

Chapreg(3H) 

Chapreg(3H) 

Chaprun(3H) 

Chapsym(3H) 

Chapsym(3H) 

Chapsym(3H) 

Chapreg(3H) 

Chapwait(3H) 

Chapalu(3H) 

Chapstack(3H) 

Chapmbus(3H) 

Chapstack(3H) 

Chapram(3H) 

Chapalu(3H) 

Chapstack(3H) 

Chapstack(3H) 

Chapsbus(3H) 

Chapspad(3H) 

Chapxbar(3H) 

Chapsym(3H) 

dbopen(3H) 

dbopen(3H) 

dumiopen(3H) 


-dynamically load and start up a file in the Chap 

-manipulate Chap diagnostic instruction register 

-read/write multiple locations in Chap instruction memory 

-read/write multiple locations in Chap scratchpad 

-dynamically load files into a Chap 

-enable/disable memory management 

-open/close a Chap device 

-read a Chap Abus device 

-read a Chap alu register 

-manipulate Chap diagnostic instruction register 

-read stacked Chap register 

-read/write Chap Mbus devices 

-read stacked Chap register 

-read/write one location in Chap instruction memory 

-read a Chap alu register 

-read stacked Chap register 

-read/write Chap runflag state 

-read Chap Sbus 

-read/write Chap Sbus device 

-read/write one location in Chap scratchpad 

-read/write Chap crossbar state 

-reset Chap and framebuffer state 

-reset Chap interrupt handling 

-reset allocation map to default state 

-run a Chap program 

-run a Chap program and return 

-manipulate dynamic loading archive list 

-set Chap interrupt handling 

-set and clear Chap breakpoints 

-get/set Chap configuration information 

-set the value of shared data register 

-set the value of virtual data register 

-single step a Chap program 

-Chap symbol table routines 

-Chap symbol table routines 

-Chap symbol table routines 

-get the base address of virtual data registers 

-pause waiting for an interrupt from a Chap 

-write a Chap alu register 

-write stacked Chap register 

-read/write Chap Mbus devices 

-write stacked Chap register 

-read/write one location in Chap instruction memory 

-write a Chap alu register 

-write stacked Chap register 

-read/write Chap runflag state 

-read/write Chap Sbus device 

-read/write one location in Chap scratchpad 

-read/write Chap crossbar state 

-Chap symbol table routines 

-setup a disk buffer device for use 

-setup a disk buffer device for use 

-setup a Dumi device for diagnostic use 
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DumiOpen 

MctrlClose 

MctrlOpen 

VideoClose 

VideoCursorOff 

VideoCursorOn 

VideoDumpCursor 

VideoGetColormap 

VideoGetFormat 

VideoGetParam 

VideoLoadCursor 

VideoOpen 

VideoSetColormap 

VideoSetCursor 

VideoSetDisplay 

VideoSetFormat 

VideoZoom 
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dumiopen(3H) 

mctrlopen(3H) 

mctrlopen(3H) 

videoopen(3H) 

videocursor(3H) 

videocursor(3H) 

videocursor(3H) 

videocmap(3H) 

videoformat(3H) 

videodisplay(3H) 

videocursor(3H) 

videoopen(3H) 

videocmap(3H) 

videocursor(3H) 

videodisplay(3H) 

videoformat(3H) 

videodisplay(3H) 


-setup a Dumi device for diagnostic use 

-setup a memory controller device for diagnostic use 

-setup a memory controller device for diagnostic use 

-open/close a video controller 

-turn video controller cursor on/off 

-turn video controller cursor on/off 

-set/get video controller cursor 

-get/set the video controller color map 

-get/set video controller display format 

-get video controller display state 

-set/get video controller cursor 

-open/close a video controller 

-get/set the video controller color map 

-set the location of a video controller cursor 

-set video controller display state 

-get/set video controller display format 

-set video controller zoom 
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NAME 

ChapReadAbusDev - read a Chap Abus device 
SYNOPSIS 

#include < pixar/pixar.h > 

u_short ChapReadAbusDev(chap, dev, bus) 

CHAP *chap; u_int dev, bus; 

DESCRIPTION 

This routine reads the contents of an Abus device. The specific Abus must be supplied in bus. Abus dev¬ 
ices are defined in the file <pixar/chap.h>. 

LIBRARY 

/usr/pixar/host/lib/libpixar. a 

SEE ALSO 

ChapOpen(3H) 
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NAME 

ChapReadReg, 

ChapReadAcc - read a Chap alu register 

ChapWriteReg, 

ChapWriteAcc - write a Chap alu register 

SYNOPSIS 

#include < pixar/pixar.h > 

ChapReadReg(chap, reg, bus) 

CHAP *chap; u int reg, bus; 

ChapReadAcc(chap, bus) 

CHAP *chap; u_int bus; 

ChapWriteReg(chap, reg, rf, v) 

CHAP *chap; u_int reg, rf; v; 

ChapWriteAcc(chap, rf, v) 

CHAP *chap; u_int rf; v; 

DESCRIPTION 

These routines read/write the contents of one 29116A RAM location (register) or accumulator in the pr 
cessors specified. The bus parameter selects the processor from which the data is to be retrieved. The 
parameter is a runflag to be used in selecting the processors to which data should be written. The r 
identifies a particular RAM location (0-31). 

LIBRARY 

/usr/pixar/host/lib/libpixar. a 

SEE ALSO 

ChapOpen(3H) 


Release 1.2 


November 24, 1986 



CHAPBPT (3H) 


Pixar Programmer’s Manual 


CHAPBPT (3H) 


NAME 

ChapSetBpt, 

ChapClrBpt - set and clear Chap breakpoints 

SYNOPSIS 

#include < pixar/pixar.h > 

ChapSetBpt(chap, addr) 

CHAP *chap; ushort addr; 

ChapClrBpt(chap, addr) 

CHAP *chap; u_short addr; 

DESCRIPTION 

ChapSetBpt and ChapClrBpt set and clear breakpoints in the specified instruction; they operate by manipu¬ 
lating the i_bpt field of the micro-instruction word. 

LIBRARY 

/usr/pixar/host/lib/libpixar.a 

SEE ALSO 

ChapOpen(3H) 
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NAME 

ChapGetConfig, 

ChapSetConfig - get/set Chap configuration information 

SYNOPSIS 

#include < pixar/pixar.h > 

ChapGetConfig(chap, conf) 

CHAP *chap; struct chapconf *conf; 

ChapSetConfig(chap, conf) 

CHAP *chap; struct chapconf *conf; 

DESCRIPTION 

ChapGetConfig returns a structure conf, containing information about the hardware configuration of a Cha 
and/or associated framebuffer. The configuration structure is defined in <pixardev/chapioctl.h> an 
described in chap (A). 

ChapSetConfig is used to set the values in the configuration structure. 

LIBRARY 

/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

ChapOpen(3H), chap(4), Chconfig (8) 
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NAME 

ChapExecInst, 

ChapLoadlnst, 

ChapReadlnst - manipulate Chap diagnostic instruction register 

SYNOPSIS 

#include < pixar/pixar.h > 

ChapExecInst(chap, ip) 

CHAP *chap; inst_t *ip; 

ChapLoadInst(chap, ip) 

CHAP *ehap; inst_t *ip; 

ChapReadInst(chap, ip) 

CHAP *chap; inst t *ip; 

DESCRIPTION 

These routines load, execute, or read a single Chap instruction. ChapLoadlnst loads one instruction into 
the instruction register, but does not execute it. ChapExecInst loads an instruction and executes it. 
ChapReadlnst returns the instruction currently in the instruction register. 

LIBRARY 

/usr/pixar/host/lib/libpixar.a 

SEE ALSO 

ChapOpen(3H) 
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NAME 


ChapLoad, 

ChapLoadSymbol, 

ChapDynamicLoad - dynamically load files into a Chap 
ChapDynamicUnload, 

ChapDynamicUnloadAll - dynamically unload files from a Chap 
ChapBeginLoad, 

ChapEndLoad - begin/end a dynamic load or unload 


SYNOPSIS 

#include < pixar/pixar.h > 

ChapLoad(chap, file, Iocs) 

CHAP *chap; char ChapLoadLocs *locs; 

ChapLoadSymbol (chap, symname, Iocs) 

CHAP *chap; char *symname; ChapLoadLocs *locs; 

ChapDynamicLoad(chap, file, Iocs) 

CHAP *chap; char *file; ChapLoadLocs *locs; 

ChapDynamicUnload(chap, file) 

CHAP *chap; char *file; 

ChapDynamicUnloadAll(chap) 

CHAP *chap; 

ChapBeginLoad(chap) 

CHAP *chap; 

ChapEndLoad(chap) 

CHAP *chap; 

DESCRIPTION 

The routines described here provide a facility for link-editing and loading Chap object files at runtim 
This “dynamic loader” package allows any relocatable object file generated by the Chap assemble 
chas( 1), or Chap link-editor, chld(l), to be linked with code already resident in a Chap. The dynam 
loader maintains a master symbol table of allocated memory and the definition of symbols resident in ti 
machine. 


Several routines exist for loading. These routines differ in terms of their interaction with libraries. Tl 
routine ChapLoad automatically searches a global list of libraries (set with ChapSetArchives, ChapPrepe 
dArchives, and ChapAppendArchives) to resolve any undefined references in a file being loaded. On tl 
other hand, the routine ChapDynamicLoad loads a single file without searching the archives. In both cast 
the file specified is scanned to find symbol definitions, then memory is allocated in instruction RAM ai 
scratchpad to accomodate the downloading of the text, data, and bss segments. Finally, once the necessa 
resources have been allocated, the module is relocated as it is downloaded into the Chap. Symbols defin 
in the file are merged into the master symbol table and any previously undefined references to exterr 
symbols defined in this module are resolved. 

The Iocs parameter allows the user to specify locations in the Chap at which to load the file. Both Ch 
pLoad and ChapDynamicLoad return the location and sizes of each segment assigned to the file as well 
the entry point in the text segment. 

ChapLoad and ChapDynamicLoad will load a module with undefined symbols, reporting each undefin 
symbol on the standard error output, but will not load a module that attempts to redefine existing symbo 
This means, for example, that two instances of the same file will not be loaded twice (presuming the sar 
symbols are defined in each file). Both routines return the number of undefined references in the load 
file, or -1 if an error was encountered. 
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The routine ChapLoadSymbol works similarly to ChapLoad, but initiates loading based on a symbol’s 
name. This is only possible when the library containing the symbol has been disclosed to a previous Chap- 
Set Archives, ChapPrependArchives, or ChapAppendArchives call. 

To unload a file previously loaded, the routine ChapDynamicUnload should be used. This routine removes 
the file's symbols from the master symbol table, releases instruction and scratchpad resources, and 
‘‘revokes” references to symbols defined in the module being unloaded. 

The routine ChapDynamicUnloadAll purges the symbol table of all files previously loaded. Note that this 
does not necessarily remove all symbols, or free up all resources. 

ENVIRONMENT VARIABLES 

CHAPDEBUG controls printing of debug messages. It is interpreted as a numeric value with bit 
fields. If CHAPDEBUG is not set, a value of zero is assumed. The bottom two bits control the 
display of loading messages on stdout as follows: 

0 - Display no messages 

1 - Display for each chap module loaded. 

2 - Display filenames 

3 - Display filenames and archive names. 

Bit 2 (numeric value 4) enables warning messages for unsatisfied externals. 

FILES 

/usr/pixar/host/symtab/chap* master symbol tables 
/dev/chap* Chap special devices 

SEE ALSO 

ChapOpen(3H), chload(l), chmap(l) 
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NAME 

ChapLoadGo - dynamically load and start up a file in the Chap 

SYNOPSIS 

#include < pixar/pixar.h > 

ChapLoadGo(chap, file, entry) 

CHAP *chap; char *file, *entry; 

DESCRIPTION 

ChapLoadGo is the simplest interface to the dynamic loading facilities, chapload( 3H). ChapLoadG 
checks to see if the module associated with the symbol entry is present in the Chap. If the code is n< 
present, file is loaded and ChapLoadGo attempts to resolve any undefined references by searching a stai 
dard set of libraries (see below). Finally, the Chap is set running at the location associated with the enti 
symbol. 


The file specified must be a relocatable object file created by chas( 1) or chld( 1). If no entry point 
specified, ChapLoadGo starts the Chap running at the first instruction in file. 


ChapLoadGo attempts to recover from running out of space in the instruction or scratchpad memories 1 
purging all resident code and data and starting over. If the second try fails for any reason, it gives up. 


ChapLoadGo returns -1 if an error occurred during loading, 0 if it was able to accomplish the wo 
without purging the symbol table, and a positive value if it had to flush the symbol table. This last indie 
tion may be of importance in case the caller is holding references to data structures previously allocated 
scratchpad. 


FILES 

/usr/pixar/chap/lib/libpG.a 

/usr/pixar/chap/lib/libpt.a 

/usr/pixar/chap/lib/libpx.a 

/usr/pixar/symtab/chap* 

/dev/chap* 


default library searched 
default library searched 
default library searched 
master symbol tables 
Chap special devices 


LIBRARY 

/usr/pixar/host/lib/libpixar. a 
SEE ALSO 

chapopen(3H), chapload(3H), chload(l), chmap(l) 
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NAME 

ChapReadMbusDev, 

ChapWriteMbusDev - read/write Chap Mbus devices 
SYNOPSIS 

#include < pixar/chap.h > 

u_short ChapReadMbusDev(chap, dev, bus) 

CHAP *chap; u_int dev, bus; 

ChapWriteMbusDev(chap, dest, rf, v) 

CHAP *chap; u_int dest, rf; u_short v; 

DESCRIPTION 

ChapReadMbusDev reads the contents of a single Mbus device. ChapWriteMbusDev writes the contents of 
one or more Mbus devices. The bus argument to ChapReadMbusDev specifies which Mbus to read from. 
The rf parameter should be a runflag that enables one or more Mbuses for writing. The dest argument to 
ChapWriteMbusDev is a mask of devices to enable for writing, as specified in <pixar/chap.h>. 

LIBRARY 

/usr/pixar/host/lib/libpixar. a 

SEE ALSO 

ChapOpen(3H) 
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NAME 

ChapAllocFB, 

ChapFreeFB, 

ChapGetFB 
ChapAllocSpad, 
ChapFreeSpad, 
ChapGetSpad 
ChapAllocRam, 
ChapFreeRam, 
ChapGetRam 
ChapGetMap 
ChapResetMap 
ChapMMan 

SYNOPSIS 

#include < pixar/pixar.h > 


allocate/free space in the framebuffer 


allocate/free space in scratchpad 


allocate/free space in instruction ram 
get allocation map from kernel 
reset allocation map to default state 
enable/disable memory management 


ChapAllocFB(chap, size) 

CHAP *chap; int size; 

ChapFreeFB(chap, addr, size) 
CHAP *chap; ushort addr, size; 

ChapGetFB(chap, addr, size) 
CHAP *chap; u short addr, size; 


ChapAllocSpad(chap, size) 

CHAP *chap; int size; 

ChapFreeSpad(chap, addr, size) 
CHAP *chap; u short addr, size; 

ChapGetSpad(chap, addr, size) 
CHAP *chap; u_short addr, size; 

ChapAllocRam(chap, size) 

CHAP *chap; int size; 


ChapFreeRam(chap, addr, size) 

CHAP *chap; u_short addr, size; 

ChapGetRam(chap, addr, size) 

CHAP *chap; ujshort addr, size; 

#include<sys/map.h> 

#include<pixardev/chapioctl.h> 

ChapGetMap(chap, map, count, pmap) 

CHAP *chap; int map, *count; struct map *pmap; 

ChapResetMap(chap, map) 

CHAP *chap; int map; 

ChapMMan(chap, onoff) 

CHAP *chap; int onoff; 

DESCRIPTION 

The routines described here interface to the memory management facilities provided by the Chap interfac 
chap (A). The device driver maintains three resource maps for tracking the use of Chap instructs 
memory, Chap scratchpad memory, and framebuffer memory (associated with a particular Chap or Chap: 
Host-based programs may allocate space from these resource maps with the ChapAllocFB , Chap/ 
locSpad, and ChapAllocRam calls. To free a previously allocated resource, the equivalent “free” routi 
should be used. Note that when freeing space the address and size must be supplied. Multiple free ca 
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may be coalesced into a single call by appropriately adjusting the address and/or size parameters. 

In addition to the normal allocation interface, a “get” interface is also supported. In this form, the alloca¬ 
tion specifies not only a size but also a location at which the allocation should be performed. 

The allocation granularity is in the natural unit of the associated resource; size parameters should be 
adjusted accordingly. 

framebuffer tile block 32x32 pixels 

scratchpad pixel 4 words 

instruction memory instruction 96-bits 

To retrieve an allocation map, or portion of, ChapGetMap should be used. The map parameter should be 
one of calloc_ram, calloc spad, or CALLOC_FB, as defined in <pixardev/chapioctl.h>. 

The routine ChapResetMap may be used to reset one or more allocation maps to their default state (every¬ 
thing free). The map parameter may be one of the map identifiers described above or calloc all (also 
defined in <pixardev/chapioctl.h>) in which case all maps are reset. Note that this routine should normally 
not be used directly as it can leave the resource allocation maps inconsistent with the contents of the sym¬ 
bol table. To cleanly flush the state of a Chap, the routine ChapReset should be used; see ChapReset{ 3H). 

The ChapMMan call controls whether the device driver intercepts interrupts from the Chap and interprets 
them, potentially, as memory management requests. If onoff is non-zero, this “memory management facil¬ 
ity is enabled; supplying a zero value for onoff disables the facility. The memory management protocol 
used is fully described in chap (A). 

LIBRARY 

/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

mman(3C), ChapOpen(3H), ChapReset(3H), chap(4) 
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NAME 

ChapOpen, 

ChapClose - open/close a Chap device 

SYNOPSIS 

#include<pixar/pixar.h> 

CHAP *ChapOpen(device, shared) 
char *device; int shared; 

ChapClose(chap) 

CHAP *chap; 

DESCRIPTION 

ChapOpen opens the specified Chap device and initializes the data structures used by the library. The de\ 
ice specifies a Chap special file as described in chap(4). The locking protocol enforced by the devic 
driver permits access to only one user at a time. Multiple processes owned by the same user may, hov, 
ever, access the same Chap depending on the shared parameter. If shared is 1, other processes requestin 
shared access may open the same Chap, otherwise noone else will be allowed to open the Chap. ChapC 
pen returns a pointer to a CHAP structure, which must be supplied in all subsequent calls to routines in th 
library. A 0 value is returned if ChapOpen was unable to open the Chap. 

The ChapClose routine closes all open files, unmaps memory previously mapped to the Chap diagnosti 
registers, and frees up all dynamically allocated memory. 

FILES 

/dev/chap* Chap special files 
LIBRARY 

/usr/pixar/host/lib/libpixar. a 

SEE ALSO 

chap(4) 

DIAGNOSTICS 

%s: Device in use. The device is currendy in use. 

%s: Device busy. The device is currendy open for exclusive use by another processor owned by th 
caller. 

In addition, there are various messages about running out of memory or being unable to open files. Th 
symbol table routines may also generate messages regarding the symbol table file. 
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NAME 

ChapReadRam, 

ChapWriteRam — read/write one location in Chap instruction memory 

ChapLoadRam, 

ChapDumpRam — read/write multiple locations in Chap instruction memory 

SYNOPSIS 

#include < pixar/pixar.h > 

ChapReadRam(chap, addr, ip) 

CHAP *chap; ushort addr; instt *ip; 

ChapWriteRam (chap, addr, ip) 

CHAP *chap; u_short addr; inst_t *ip; 

ChapLoadRam(chap, addr, count, ip) 

CHAP *chap; u short addr, count; inst t *ip; 

ChapDumpRam(chap, addr, count, ip) 

CHAP *chap; u short addr, count; inst t *ip; 

DESCRIPTION 

These routines read and write Chap instruction memory. ChapReadRam and ChapWriteRam read and 
write a single Chap instruction at the address specified. ChapLoadRam and ChapDumpRam perform the 
equivalent operations, but for multiple instructions. 

LIBRARY 

/usr/pixar/host/lib/libpixar. a 

SEE ALSO 

ChapOpen(3H) 
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NAME 

ChapSetSDR 

ChapGetSDR 

ChapSetVDR, 

ChapVdregBase - Chap sysbus register routines 

SYNOPSIS 

#include < pixar/chapdiag.h > 

ChapSetSDR(chap, reg, value) 

CHAP ♦chap; int reg; int value; 

int ChapGetSDR(chap, reg) 

CHAP *chap; int reg; 

ChapSetVDR(chap, reg, value) 

CHAP *chap; int reg; int value; 

int *ChapVdregBase(chap) 

CHAP *chap; 


DESCRIPTION 

These routines access the sysbus (sixteen-bit wide shared data registers) of the chap from the host. There 
are sixteen sysbus registers which may be used for communication with a running chap program. There are 
two modes of communication with the chap through these registers. Both modes require first opening the 
chap with ChapOpen() and ChapMMan() calls. 

The first method, via ChapSetSDRQ and ChapGetSDR() requires no host handshaking with the chap. The 
register number, reg must be one of the first fourteen registers (0 through 13). Any sixteen bit value may 
be placed into the register by ChapSetSDR(chap,reg,value). Similarly, a value may be read by the host 
from the sysbus with a ChapGetSDR(chap.reg) call, which returns the value in the register. The chap reads 
and writes the sysbus with the chas symbol sysbus<n> , where n is the register number. This symbol may 
be used like any other scalar chap symbol. Seechas(lH). 

The second method allows explicit synchronization between the host and chap. The chap sysbus has 256 
virtual data registers (VDRs) which are accessed with the ChapSetVDR() command. The chap must 
respond to this write command by acknowledging with the chas statement "sysrel-1" before the bus times 
out and the host faults. There is just enough time for the chap to retrieve the value from the sysbus and 
acknowledge the VDR transfer. These registers are called VDRs because they are simulated on the sysbus 
by sysbus registers 14 and 15. Sysbus<14> will contain the reg and sysbus<15> will contain the value. 
Obviously, sysbus<14> and sysbus<15> are off-limits to all SDR transfers. A more detailed explanation of 
the mechanism for synchronization may be found in the Chap Programming Tutorial 

The call ChapVdregBaseQ will return the base of the VDR addresses, which can be used to read the virtual 
data registers. Indirecting through this pointer (reference only as an unsigned short or short) will return the 
value in sysbus<15>. 

NOTES 

The shared data register sysbus<13> is used by several Pixar application programs, including Chad*(3H) 
for synchronization during SDR transfers. This register should also be considered off-limits, unless its use 
in the application is carefully understood. 

LIBRARY 

/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

ChapOpen(3H), Chad*(3H), ChapMMan(3H), Chas(lH) 
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NAME 

ChapReset - reset Chap and framebuffer state 

SYNOPSIS 

#include < pixar/pixar.h > 

ChapReset(chap) 

CHAP *chap; 

DESCRIPTION 

ChapReset flushes the symbol table and resets all the resource allocation maps manipulated by the kernel. 
This call should be used with care as it destroys all information about loaded Chap code. 

LIBRARY 

/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

ChapOpen(3H), ChapMMan(3H), chap(4) 
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NAME 

ChapRun, 

ChapRunAsync, 

ChapCont, 

ChapHalt, 

ChapS tep - Chap runtime control 

SYNOPSIS 

#include < pixar/pixar.h > 

ChapRun(chap, pc) 

CHAP *chap; u_short pc; 

ChapRunAsync(chap, pc) 

CHAP *chap; int pc; 

ushort ChapCont(chap) 

CHAP *chap; 

u short ChapHalt(chap) 

CHAP *chap; 

ChapStep(chap, byinst) 

CHAP *chap; int byinst; 

DESCRIPTION 

These routines are available for controlling the execution of a Chap. ChapRun initializes the Chap runflags 
to Oxf, sets the stack-pointer to 0, and starts the Chap running at the specified address. ChapRun does not 
return until the Chap hits a breakpoint or the user types an interrupt on the keyboard. ChapRun returns the 
pc of the instruction where the Chap was stopped. 

ChapRunAsync starts the Chap running as in ChapRun , but returns immediately. 

ChapCont restarts the Chap at the place where it was last stopped. This routine does not return until a 
breakpoint is encountered, or the user types an interrupt on the keyboard. ChapCont returns the pc of the 
instruction at which the Chap was stopped. 

ChapHalt halts the Chap. The current value of the program counter is returned. The machine is never 
halted in the middle of an instruction. 

ChapS tep single steps the Chap either one instruction, or one clock tick, depending on the value of byinst. 
byinst indicates the number of instructions to step at one time. When single-stepping one instruction, 
instructions which have the special bit on are executed, but not counted. 

LIBRARY 

/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

ChapOpen(3H) 

BUGS 

It is inadvisable to single step into the middle of a Chap instruction and then examine the internal state of a 
Chap; the library does not preserve enough internal state to do this correctly. 
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NAME 

ChapReadSbus - read Chap Sbus 

ChapReadSbusDev, 

ChapWriteSbusDev - read/write Chap Sbus device 

SYNOPSIS 

#include < pixar/pixar.h > 

ChapReadSbus(chap) 

CHAP *chap; 

ChapReadSbusDev(chap, dev, reg) 

CHAP *chap; u_int dev, reg; 

ChapWriteSbusDev(chap, dev, reg, v) 

CHAP *chap; u_int dev, reg; u_short v; 

DESCRIPTION 

ChapReadSbus returns the contents of the Sbus by unloading the current instruction and Sbus contents 
from the shadow register. 

ChapReadSbusDev and ChapWriteSbusDev read and write the contents of an Sbus device. If the device 
specified in dev is a base or index register, the reg parameter is used to identify the* particular register. 
Scalar devices are defined in the file <pixar/chap.h>. 

LIBRARY 

/usr/pixar/host/lib/libpixar.a 

SEE ALSO 

ChapOpen(3H) 
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NAME 

ChapReadSpad, 

ChapWriteSpad 

ChapLoadSpad, 

ChapDumpSpad 

ChapFillSpad 

ChapAfillSpad 

SYNOPSIS 

- read/write one location in Chap scratchpad 

- read/write multiple locations in Chap scratchpad 

- fill Chap scratchpad memory with a single value 

- fill each Chap scratchpad memory with its address 



#include < pixar/pixar.h > 

u_short ChapReadSpad(chap, addr, mode, comp) 

CHAP *chap; u_short addr; u_int mode, comp; 

ChapWriteSpad(chap, addr, mode, comp, v) 

CHAP *chap; ushort addr; uint mode, comp; ushort v; 

ChapLoadSpad(chap, addr, count, data) 

CHAP *chap; u_short addr, count, data[]; 

ChapDumpSpad(chap, addr, count, data) 

CHAP *chap; u_short addr, count, data[]; 

ChapFlllSpad(chap, addr, count, fill) 

CHAP *chap; u_short addr, count; u_short fill; 

ChapAfillSpad(chap, addr, count) 

CHAP *chap; u short addr, count; 

DESCRIPTION 

ChapReadSpad and ChapWriteSpad read and write one 16-bit component in scratchpad memory using the 
addressing mode specified. The comp parameter identifies the component to be stored/retrieved. The addr 
parameter specifies the address in scratchpad. This address is shifted left two bits before passing to the 
Chap. For component, pixel, and broadcast read accesses, the address is placed in base register 15. For 
index mode read accesses, the address is supplied from the immediate field of the loaded instruction. All 
write accesses use base register 15 to supply the address. The contents of base register 15 is left unchanged 
after the operation. 

ChapLoadSpad loads count words of data into scratchpad memory at the address specified. Data is loaded 
untessellated. 

ChapDumpSpad retrieves count words of data from scratchpad, beginning at location addr. 

ChapFillSpad fills count words of scratchpad memory with the value fill. This is useful, for example, in 
zeroing memory. ChapAfillSpad fills count memory locations starting at addr with each location’s 
untessellated word address; this is used mostly for diagnostics. 

LIBRARY 

/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

ChapOpen(3H) 


Release 1.2 


November 24,1986 


1 



CHAPSTACK ( 3H ) 


Pixar Programmer’s Manual 


CHAPSTACK (3H) 


NAME 

ChapReadPc, 

ChapReadLc, 

ChapReadRunflag - read stacked Chap register 

ChapWritePc, 

ChapWriteLc, 

ChapWriteRunflag - write stacked Chap register 
ChapReadRunflags, 

ChapWriteRunflags - read/write Chap runflag state 
SYNOPSIS 

#include < pixar/pixar.h > 

u_short ChapReadPc(chap) 

CHAP *chap; 

u_short ChapReadLc(chap) 

CHAP *chap; 

u_short ChapReadRunflag(chap) 

CHAP *chap; 

ChapWritePc(chap, pc) 

CHAP *chap; u_short pc; 

ChapWriteLc(chap, lc) 

CHAP *chap; ushort lc; 

ChapWriteRunflag(chap, rf) 

CHAP *chap; u_short rf; 

ChapReadRunflags(chap, rf) 

CHAP *chap; Runflags *rf; 

ChapWriteRunflags(chap, rf) 

CHAP *chap; Runflags *rf; 

DESCRIPTION 

These routines read and write registers saved and restored on the Chap runtime stack. ChapReadPc, 
ChapReadLc, ChapReadRunflag, ChapWritePc, ChapWriteLc, and ChapWriteRunflag manipulate the 
current value of each register. ChapReadRunflags and ChapWriteRunflags affect the previous, current, 
and next runflags (runflag values are passed in the Runflags structure defined in <pixar!chapdiag.h>). 

LIBRARY 

/usr/pixar/host/lib/libpixar.a 

SEE ALSO 

ChapOpen(3H) 
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NAME 

ChapS ymLookup, 

ChapS ymEnter, 

ChapSymX, 

ChapXSym - Chap symbol table routines 

SYNOPSIS 

#include < pixar/pixar.h > 

LoadSym **ChapSymLookup(chap, name, force) 

CHAP *chap; char ♦name; int force; 

ChapSymEnter(chap, hp, cp) 

CHAP *chap; LoadSym **hp, *cp; 

ChapSymX(chap, sp) 

CHAP *chap; LoadSym *sp; 

LoadSym *ChapXSym(chap, i) 

CHAP *chap; int i; 

DESCRIPTION 

These routines deal with the symbol table maintained for each Chap. The symbol table is automatically 
opened at the time the Chap is opened with ChapOpen. The routine ChapSymLookup may be used to con¬ 
vert a symbol’s name to a pointer to the appopriate symbol table entry (th q force parameter should always 
be 0, it is needed internally for forcing the installation of local symbols), while the ChapSymX and ChapX¬ 
Sym routines are used to convert symbol table pointers to indices and back again (the latter actually being a 
macro defined in the include file). 

LIBRARY 

/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

ChapOpen(3H), ChapS ym (5) 
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NAME 

ChapWaitForlnterrupt - pause waiting for an interrupt from a Chap 
ChapSetlnterrupt, 

ChapResetlnterrupt - set/reset Chap interrupt handling 
SYNOPSIS 

#include < pixar/pixar.h > 

ChapWaitForlnterrupt(chap) 

CHAP *chap; 

ChapSetInterrupt(chap, sig) 

CHAP *chap; int sig; 

ChapResetlnterrupt(chap) 

CHAP *chap; 

DESCRIPTION 

ChapWaitForlnterrupt causes the program to pause awaiting a user interrupt from the specified Chap or an 
interrupt from the keyboard. ChapWaitForlnterrupt returns 1 if it was interrupted by a keyboard interrupt, 
0 otherwise. 

ChapSetlnterrupt enables interrupt handling by performing a CHAPIOSSIG ioctl{ 2) call. The previous 
interrupt handling state is saved in a private variable and used by ChapResetlnterrupt to reset the previous 
interrupt handling state. When signals are enabled with ChapSetlnterrupt, the signal sig is sent to the cal¬ 
ling process each time a Chap user interrupt is delivered to the host. It is the caller’s responsibility to 
enable a signal handling routine with signal (3C) or sigvec(2). 

Beware that interrupts from the Chap may, surreptitiously, be intercepted by the device driver if “memory 
management’’ is enabled, see ChapMMan(3Y£). 

LIBRARY 

/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

sigvec(2), signal(3C), ChapOpen(3H), ChapMMan(3H), chap(4) 

BUGS 

ChapWaitForlnterrupt only handles one Chap. 
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NAME 

ChapReadXbar, 

ChapWriteXbar - read/write Chap crossbar state 

SYNOPSIS 

#include < pixar/chapdiag.h > 

ChapReadXbar(chap, xbar) 

CHAP *chap; XbarState *xbar; 

ChapWriteXbar(chap, xbar) 

CHAP *chap; XbarState *xbar; 

DESCRIPTION 

These routines read/write the state of the crossbar. The structure 
<pixarlchapdiag.h>. 

LIBRARY 

/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

ChapOpen(3H) 


CHAPXBAR (3H) 


XbarState is defined in 
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NAME 

DbOpen, 

DbClose - setup a disk buffer device for use 

SYNOPSIS 

#include<pixar/pixar.h> 

DB *DbOpen(device, size) 
char * device; int size; 

DbClose(dbp) 

DB *dbp; 

DESCRIPTION 

DbOpen and DbClose support the disk buffer associated with each Dumi device. The disk buffer allows 
high speed transfer of data by having the Dumi generate the Sysbus addresses for each word of data 
transferrred. This can significantly increase the transfer rate between the host and the Chap (or a device, 
such as a disk resident on the host’s bus.) 

DbOpen opens the specified disk buffer and maps sufficient memory to contain a disk window of size 
bytes. This area in the process’s address space is made available through the db_bp memory of the 
returned DB structure. In normal operation, this pointer is then used in a read operation or one of the spe¬ 
cial purpose ioctl calls described in chap {A). 

DbClose closes the disk buffer and unmaps the associated memory. 

FILES 

/dev/db* disk buffer special files 
LIBRARY 

/usr/pixar/host/lib/libpixar.a 

SEE ALSO 

dumi(4), chap(4) 

DIAGNOSTICS 

%s: Device in use. The device is currently in use by another person. 

In addition, there are various messages about running out of memory and being unable to open files. 
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NAME 

DumiOpen, 

DumiClose - setup a Dumi device for diagnostic use 

SYNOPSIS 

#include<pixar/dumireg.h> 

DUMI *DumiOpen(device) 
char ^device; 

DumiClose(dumi) 

DUMI *dumi; 

DESCRIPTION 

DumiOpen opens the specified Dumi device. The device is a special file as described in dumi(4). 
DumiOpen maps the Dumi diagnostic registers into the calling process’s address space and returns a 
pointer to that area as d_dumi in the returned structure. 

DumiClose closes the Dumi and unmaps the associated diagnostic registers. 

In supporting the Dumi the caller is expected to use definitions found in the include file 
<pixardev!dumireg.h>. In particular, this file defines the structure of the bank of diagnostic registers pro¬ 
vided by the Dumi and mapped into the process’s address space by the library. <dumireg.h> is automati¬ 
cally included by <pixarlpixar.h>. 

FILES 

/dev/dumi* Dumi special files 
LIBRARY 

/usr/pixar/host/lib/libpixar.a 

SEE ALSO 

dumi(4) 

DIAGNOSTICS 

%s: Device in use. The device is currently in use. 

In addition, there are various messages about running out of memory or being unable to open files. 
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NAME 

MctrlOpen, 

MctrlClose - setup a memory controller device for diagnostic use 

SYNOPSIS 

#include<pixar/pixar.h> #include<pixardev/mctrlreg.h> 

MCTRL *MctrIOpen(device) 
char * device; 

MctrlClose(mctrl) 

MCTRL *mctrl; 

DESCRIPTION 

MctrlOpen opens the specified memory controller device. The device is a special file described in 
mctrl(A). MctrlOpen maps the memory controller diagnostic registers into the calling process’s address 
space and returns a pointer to that area as mcjnctrl in the returned structure. 

MctrlClose closes the memory controller and unmaps the associated diagnostic registers. 

In supporting the Pixar memory controller, the caller is expected to use the definitions found in 
<pixardevlmctrlreg.h>. In particular, this file defines the structure of the diagnostic registers provided by 
the memory controller and mapped into the process’s address space by the library, mctrlreg.h is automati¬ 
cally included by <pixarlpixar.h>. 

FILES 

/dev/mctrl* memory controller special files 
LIBRARY 

/usr/pixar/host/lib/libpixar.a 

SEE ALSO 

mctrl(4) 

DIAGNOSTICS 

%s: Device in use. The device is currently in use. 

In addition, there are various messages about running out of memory or being unable to open files. 
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NAME 

VideoGetColormap, 

VideoSetColormap - get/set the video controller color map 
SYNOPSIS 

# include "/usr/pixar/include/pixar/video.h" 

VideoGetColormap(video, r, g, b) 

VIDEO 

♦video; u_short r[1024], g[1024], b[1024]; 

VideoSetCoiormap(video, r, g, b) 

VIDEO 

♦video; ushort r[1024], g[1024], b[1024]; 

DESCRIPTION 

VideoGetColormap fills supplied arrays with the contents of the colormap. 

VideoSetColormap sets the colormap with the values specified in the given arrays. 

The Pixar colormap provides the information which the video board uses to assign output intensities to 
pixel values. Each channel, red, green, and blue, has a separate map. Each map contains 1024 entries. 
This reflects the fact that only the top 10 bits of the pixel value are used as input to the colormaps. (2" 10 = 
1024). Colormap entries, on the other hand, are 12-bit fractions. This means that that full intensity for a 
channel is represented by the value 4096, which is the value 1 shifted left 12 bit positions. Hence, to con¬ 
vert a floating point value c (0<c<l), representing an intensity, into a colormap entry ic , 
ic = (u_short) (c ♦ 4096); 

LIBRARY 

/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

videoopen(3H), video(4) /usr/pixar/tutorial/contour.c 
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NAME 

VideoLoadCursor, 

VideoDumpCursor - set/get video controller cursor 
VideoCursorOn, 

VideoCursorOff - turn video controller cursor on/off 

VideoSetCursor - set the location of a video controller cursor 

SYNOPSIS 

VideoLoadCursor(video, n, cp) 

VIDEO *video; int n; CURSOR *cp; 

VideoDumpCursor(video, n, cp) 

VIDEO *video; int n; CURSOR *cp; 

VideoCursorOn(video, n) 

VIDEO *video; int n; 

VideoCursorOff(video) 

VIDEO *video; 

VideoSetCursor(video, x, y) 

VIDEO * video; int x, y; 

char *sp; 

DESCRIPTION 

Cursors are defined by the CURSOR structure defined in <pixar/video.h>. The Pixar video controller is 
capable of controlling four hardware cursors. These cursors may be up to 128 pixels on a side. The 
hardware cursor does not affect the frame buffer memory. The color of the active points in the hardware 
cursor is “super-white”, so it can be distinguished from any color in the regular image. 

VideoLoadCursor loads the video controller’s nth cursor with the values specified in cp. If the cursor 
dimensions are less than 128 pixels on a side, the remaining space is zero filled (invisible). A cursor’s 
location (X and Y coordinates) is translated from the hardware cursor location according to the X and Y 
“hot spot” (offsets) specified in the CURSOR structure. Each bit in the cursor’s data representation 
corresponds to a pixel. The first bit of a cursor’s data representation corresponds to the upper left hand 
comer of the cursor, as represented on the screen. 

VideoDumpCursor retrieves the representation for the nth cursor and stores it in the data area associated 
with cp. The height and width of the cursor are taken from the cursor structure. Data is returned in a for¬ 
mat suitable for use with VideoLoadCursor. 

VideoCursorOn and VideoCursorOff turn the display of cursor n on or off, respectively. If the cursor 
number specified is negative, the current cursor is assumed. 

VideoSetCursor sets the position of the current cursor. The X and Y positions are relative to the window 
associated with v. If a cursor hasn’t yet been loaded, this call has no effect. 

The current cursor location may be found in the vjc, and v_y members of the VIDEO structure. 

LIBRARY 

/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

videoopen(3H), video(4) 
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NAME 

VideoGetParam 
VideoZoom 
VideoSetDisplay 

SYNOPSIS 

VideoGetParam(video) 

VIDEO *video; 

VideoZoom(video, zoom) 

VIDEO *video; 
int zoom; 

VideoSetDisplay (video, base, width, height, x, y, mode) 

VIDEO *video; 

int base, width, height, x, y, mode; 

DESCRIPTION 

VideoGetParam updates the internal library state maintained in the VIDEO structure video. It need never 
be called unless the video controller registers are manipulated directly through the hardware registers. 

VideoZoom sets the current magnification value for the video controller. The video controller implements 
magnification by pixel replication. Magnification values out of range, less than ZOOM_MIN (1) or greater 
than ZOOM_MAX (16), are clamped at the extremes. The window is automatically adjusted to maintain the 
cursor in the same relative position on the screen. 

VideoSetDisplay sets the display window according to the parameters specified. The upper left hand comer 
of the window is set to be (x, y ) pixels offset from the specified base (with scaling applied to take into 
account the current magnification). The width and height of the display, in tiles, are set according to width 
and height. The mode should be one of: 

VMODE_RGB display the red, green, and blue channels 
VMODE_ALPHA display the alpha channel 
VMODE_BLANK blank the screen 
VMODE_RED feed the red channel to all three color guns 
VMODE_GREEN feed the green channel to all three color guns 
VMODE_BLUE feed the blue channel to all three color guns 

If the X or Y offsets are out of range, they are clipped according to the dimensions of v. 

LIBRARY 

/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

videoopen(3H), video(4) 


- get video controller display state 

- set video controller zoom 

- set video controller display state 
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NAME 

VideoGetFormat, 

VideoSetFormat - get/set video controller display format 

SYNOPSIS 

int VideoGetFormat(video) 

VIDEO *video; 

VideoSetFormat(video, format, freq) 

VIDEO *video; 
int format, freq; 

DESCRIPTION 

VideoGetFormat returns the current video controller format , a packed value containing information about 
the video configuration and clock oscillator frequency. Format information is unavailable on older video 
controllers (a -1 value is returned). 

VideoSetFormat sets the current format select and clock oscillator frequency. Video formats are a property 
of a prom on the video controller. Each PROM contains configuration information for up to four different 
video formats. The format parameter selects the set of parameters in the prom to use. The frequency 
parameter selects which crystal, of four possible, to use. In normal operation, both parameters will 
correspond to the same video format. The following formats are currently defined: 

VFORM_fflDEF Hi-definition (1024x768) 

VFORM_NTSC NTSC (512x488) 

while the following frequency definitions exist: 

VFREQJUDEF Hi-definition (1024x768) 

VFREQ_NTSC NTSC (512x488) 

LIBRARY 

/usr/pixar/host/lib/libpixar.a 
SEE ALSO 

video(l), videoopen(3H), video(4) 
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NAME 

VideoOpen, 

VideoClose - open/close a video controller 

SYNOPSIS 

#include<pixar/pixar.h> 

VIDEO *VideoOpen(device, width, height, shared) 

char *device; 

int width, height, shared; 

VideoClose(video) 

VIDEO *video; 

DESCRIPTION 

VideoOpen opens the video controller associated with the character special device device. If shared is 
non-zero, the device is opened with shared access, otherwise it is opened for exlusive use by the caller. A 
window onto the framestore is created with the specified dimensions (measured in pixels). The pointer 
returned by VideoOpen should be used in subsequent calls to routines described here. 

VideoClose closes a previously opened video controller window. 

The video controller support routines access the device through registers mapped into a process’s address 
space. 

In supporting the video controller definitions, the files <pixar/video.h> and <pixardev/videoreg.h> are 
used. These files are automatically included by <pixar/pixar.h>. 

FILES 

/dev/video* video controller special files 
LIBRARY 

/usr/pixar/host/lib/libpixar.a 

SEE ALSO 

video(4G) 

DIAGNOSTICS 

%s: Device in use. The device is currently in use. 

%s: Device busy. The device is currently open for exclusive use by another processor owned by the 
caller. • 

In addition, there are various messages about running out of memory or being unable to open files. 
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NAME 

intro - introduction to Chap library functions 

DESCRIPTION 

This section describes functions that may be found in various Chap libraries. The functions described in 
this section are grouped into the following subsections: 

libpip This library contains common image processing functions. Included are routines to perform 1- 
dimensional and 2-dimensional convolution, box filtering, image arithmetic, histograms and find 
minimum and maximum image values. 

libpx This library contains routines to geometrically transform images. There are procedures to change 
the size of an image using linear, quadratic or cubic interpolation. A procedure exists to decrease 
the size of an image. Other procedures can be used to rotate and warp images. 

libpt This library contains procedures to transfer pixels to and from frame buffer memory and scrath- 
pad memory. Included are procedures to clear memory, to copy from frame buffer to frame 
buffer, to transpose and reflect a frame buffer and to circularly shift pictures. Procedures also 
exist to perform component shuffling. Finally, this library also contains functions to perform sin¬ 
gle pixel operations. These include multiplying, channel arithmetic, clamping an image to the 
range 0 to 1. The procedures to do compositing also lie in the library. 

libpm This library contains common arithmetic functions such as extended precision arithmetic, square 
roots, reciprocals, random number generation, and matrix multiplication. 

libpG This library contains general purpose procedures. Currently, it contains routines to manipulate 
the register stack. 

libcolor This library contains routines for performing color-space transformations. 

All Chap library procedures are described in these manual pages using a C-like syntax. It’s important, 
however, when calling these procedures to know how arguments are passed to them. This subject is dis¬ 
cussed is more detail in Introduction to Pixar Programing with Chad. 

Arguments are passed to functions by placing them in arithmetic, base and index registers. There are 16 
base registers named b0-bl5, 16 index registers named i0-il5, and 32 arithmetic registers named r0-r31. 
The base and index registers contains a single value whereas the arithmetic registers contains 4-values. If a 
single value is to be passed via an arithmetic register it is usually assigned to all 4 of its components. 

Arguments are placed in registers in the order in which they appear in the command list Integer values are 
passed using arithmetic registers and pointer values are passed using base registers. In a few instances 
pointers are passed in index registers. This is indicated by the keyword index. 

As an example here is the declaration of SSClamp and how it would be called on the Chap. 

SSClamp(src, dst, n) 
pixel *src, *dst; 
int n; 

bO = src; 
bl = dst; 
i0 = n; 

jsr SSClamp; 

The same function would be called from Chad as follows: 

ChadWrite( Chap, 

BO, srcaddr, 

Bl, dstaddr, 

RO, n, 

NIX); 


Release 1.2 


December 1,1986 


1 



INTRO ( 3C) 


Pixar Programmer’s Manual 


INTRO (3C) 


In the following man pages, these types are assumed: 
pw - pixel window 

pixel - RGBA tesselated pixel (address a multiple of 4) 
component - CCCC tesselated pixel 
int - any memory location 

Furthermore, the name src is used for a source buffer and dst for a destination buffer. If there is more than 
one source or destination, they are numbered. 

LIBRARY 

libpm, libpm.3c, libpt, libpt.3c 
SEE ALSO 

intro(3H), intro(3), The Chad Tutorial. 
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NAME 

libcolor - introduction to Pixar color-transformation library 

DESCRIPTION 

libcolor contains routines for performing color-space transformations on the channel values of pixels. 
LIBRARY 

/usr/pixar/chap/lib/libcolor.a 
SEE ALSO 

intro(3C), libpG(3C), libpip(3C), libpm(3C), libpt(3C), libpx(3C) 

LIST OF FUNCTIONS 

Name Page Description 

rgb2XYZ rgb2XYZ(3C) - convert red-green-blue values to unnormalized CIE coordinates 

rgb2xyY rgb2xyY(3C) - convert red-green-blue values to CIE coordinates 

SSClamp SSClamp(3C) - clamp pixel values to the range [0,1.0E]. 

XYZ2rgb XYZ2rgb(3C) - convert unnormalized CIE coordinates to red-green-blue values 
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NAME 

rgb2xy Y - convert red-green-blue values to CIE coordinates 

SYNOPSIS 

rgb2xyY(src, n, dst, MatrixPtr) 
pixel src, dst; register n; 
pixel MatrixPtr; 

DESCRIPTION 

rgb2xyY converts red-green-blue pixel values to CIE coordinates (x,y,Y). src holds the address of the input 
buffer, dst holds the address of the output buffer (which may be the same as the input buffer), MatrixPtr 
holds the address of the transformation matrix and n holds the number of pixels in the buffers. The 
transformation matrix is a 3x4 matrix (the fourth column isn’t used) that transforms (R,G,B) to (X,Y,Z) 
space. This matrix is dependent on the phosphors that properly represent the (R,G,B) values. rgb2xyY nor¬ 
malizes the resultant (X,Y,Z) and writes x, y and Y in the red, green and blue channels, respectively, of the 
output buffer, x and y are unsigned 16-bit fractions. Y is an integer. The alpha channel of the output 
buffer is unchanged. 

The following procedure computes the matrices needed to transform between (r, g, b)-space and CIE-space 
for a particular monitor. Let [R, G, B] be the measured CIE coordinates of the red, green and blue phos¬ 
phors of the monitor. These may be obtained from the manufacturer or, better yet, measured directly with 
a colormeter. Let W be the CIE-coordinates of the white to which the monitor is balanced. This typically 
is 6500 °K, the coordinates of which are (.3127, .3290, .3583). 

First compute the weighting vector: 


(lr,l g ,h) = W\ 


-1 


Given this, the transformation matrices are computed as follows: 


(X,7,Z) = (r,g,i>) 



(r,g,b)=(X,Y,Z) 



-l 


LIBRARY 

libcolor.a 


SEE ALSO 

xyY2dens(3C), dens2rgb(3C) 
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NAME 

rgb2XYZ - convert red-green-blue values to unnormalized CIE coordinates 

SYNOPSIS 

rgb2XYZ(src, n, dst, MatrixPtr) 
pixel src, dst; register n; 
pixel MatrixPtr; 

DESCRIPTION 

rgblXYZ converts red-green-blue pixel values to unnormalized CIE coordinates (IX, Y, Z). src holds the 
address of the input buffer, dst holds the address of the output buffer (which may be the same as the input 
buffer), MatrixPtr holds the address of the transformation matrix and n holds the number of pixels in the 
buffers. The transformation matrix is a 3x4 matrix (the fourth column isn’t used) that transforms (R, G, B) 
to (X, Y, Z) space. This matrix is dependent on the phosphors that properly represent the (R, G, B ) values. 
The alpha channel of the output buffer is unchanged. 

The following procedure computes the matrices needed to transform between (r, g, by space and CIE-space 
for a particular monitor. Let [/?, G, B] be the measured CIE coordinates of the red, green and blue phos¬ 
phors of the monitor. These may be obtained from the manufacturer or, better yet, measured directly with 
a colormeter. Let W be the CIE-coordinates of the white to which the monitor is balanced. This typically 
is 6500° K, the coordinates of which are (.3127, .3290, .3583). 

First compute the weighting vector: 


«r,l g ,lb) = W 



-1 


Given this, the transformation matrices are computed as follows: 

, IrR 

(X,Y,Z) = (r ,g,b)\ /gG 


(r,g,B) = (X,Y,Z) 

LIBRARY 


IrR 

LG 

LB 


-l 


libcolor.a 
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NAME 

SSClamp - clamp pixel values to the range [0,1.0E]. 

SYNOPSIS 

SSClamp(src, dst, count) 
pixel *src, *dst; register count; 

DESCRIPTION 

SSClamp clamps pixel values to the range [0,1.0E]. src holds the address of the input buffer, dst holds the 
address of the output buffer (which may be the same as the input buffer), n holds the number of pixels in 
the buffers. Pixel values less than zero are set to zero and pixel values greater than 1.0E (2048) are set to 
one. 

LIBRARY 

libcolor.a 
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NAME 

XYZ2rgb - convert unnormalized CIE coordinates to red-green-blue values 

SYNOPSIS 

XYZ2rgb(src, n, dst, MatrixPtr) 
pixel src, dst, MatrixPtr; register n; 

DESCRIPTION 

XYZ2rgb converts unnormalized CIE coordinates (X, Y, Z) to red-green-blue pixel values, src holds the 
address of the input buffer, dst holds the address of the output buffer (which may be the same as the input 
buffer), MatrixPtr holds the address of the transformation matrix and n holds the number of pixels in the 
buffers. The transformation matrix is a 3x4 matrix (the fourth column isn’t used) that transforms (X, Y, Z) 
to (R, G, B) space. This matrix is dependent on the phosphors that properly represent the (R, G, B) values. 
The alpha channel of the output buffer is unchanged. 

The following procedure computes the matrices needed to transform between (r, g, b)-space and CIE-space 
for a particular monitor. Let [R, G, B ] be the measured CIE coordinates of the red, green and blue phos¬ 
phors of the monitor. These may be obtained from the manufacturer or, better yet, measured directly with 
a colormeter. Let W be the CEE-coordinates of the white to which the monitor is balanced. This typically 
is 6500 °K, the coordinates of which are (.3127, .3290, .3583). 

First compute the weighting vector. 


(W*,4) = W 


-l 


Given this, the transformation matrices are computed as follows: 


(X,Y,Z) = (r,g,b) 


l r R 

LG 

4b 


(r,g,b) = (X,Y,Z) 
LIBRARY 


l r R 

LG 

f„B 


-l 


libcolor.a 
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NAME 

libpG - introduction to Pixar library of general-purpose Chap routines. 

DESCRIPTION 

libpG contains general purpose procedures for the Channel Processor. Currently, it contains routines to 
manipulate the register stack. 

LIBRARY 

/usr/pixar/chap/lib/libpG.a 
SEE ALSO 

intro(3C), libcolor(3C), libpip(3C), libpm(3C), libpt(3C), libpx(3C) 


LIST OF FUNCTIONS 

Name Page 

ALLOC mman(3c) 

MFREE mman(3c) 

MGET mman(3c) 

initstack stack(3C) 

pushb, popb stack(3C) 
pushi, popi stack(3C) 
pushr, popr stack(3C) 
pushv, popv stack(3C) 


Description 

- memory management support 

- memory management support 

- memory management support 

- initialize the register stacking mechanism 

- save and restore base registers from scratchpad stack 

- save and restore index registers from scratchpad stack 

- save and restore ALU registers from scratchpad stack 

- save and restore all volatile registers from scratchpad stack 


Release 1.2 


November 24,1986 
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NAME 

ALLOC, 

MFREE, 

MGET - memory management support 

SYNOPSIS 

#include<pixar/mman.h> 

acc ALLOC(map, size, elabel) 
acc MFREE(map, addr, size, elabel) 
acc MGET(map, addr, size, elabel) 

DESCRIPTION 

These macros implement the Host-Chap memory management protocol described in chap {A). Each macro 
takes a map parameter indicating whether SPAD (Chap scratchpad memory) or FB (framebuffer memory) is 
to be allocated, and the appropriate parameters for the request. The size and addr parameters must be in 
the appropriate allocation units: pixels for SPAD and tiles for FB. The elabel parameter is a program label 
to which the code will jump in case of an error. ALLOC and MGET return an unsealed result in acc. 
MFREE overwrites acc with a success/failure indication. 

Sysbus registers 9-13 are used when communicating with the host. 

LIBRARY 

libpg.a 

SEE ALSO 

chap(4) 

DIAGNOSTICS 

A -1 is returned in acc from the host when an error is encountered. 


Release 1.2 
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NAME 

initstack 
pushb, popb 
pushi, popi 
pushr, popr 
pushv, popv 

SYNOPSIS 

initstackO 
pushb() 
popbO 

pushi() 

popiO 

pushr(n) 
accumulator n; 

popr() 

pushv() 

popv() 

DESCRIPTION 

Certain assumptions are made across procedure calls about the sanctity of registers. The first 25% of regis¬ 
ters are volatile, the last two registers are off-limits, and the others are sacred. Thus, the volatile registers 
are acc, r0-r7, b0-b3, i()-i3. The sacred registers are r8-r29, b4-bl3, i4-il3. Do not use r30, r31, bl4, 
bl5, il4, or il5. bl5 is used as a stack pointer. 115 is used as a temporary index register by these stacking 
routines. il4 is used as a structure pointer by the “variables” package. bl4 is used as a temporary field 
pointer by the variables package. r31 is used as a temporary by these routines. 

Routines may use any volatile register for local variables, or to receive arguments or return values. Rou¬ 
tines must restore sacred registers upon exit. Thus, if a routine requires more registers than the volatile 
ones, some of the sacred registers should be stored upon entry and restored before exit. A scratchpad stack 
is maintained for storing registers. 

initstack initializes the stack. This is a good routine to call on the first line of every program, because many 
library routines expect to use the stacking calls, pushb stores all the sacred base registers, and popb 
restores them, pushi stores all the sacred index registers, and popi restores them, pushr stores the n regis¬ 
ters r8, r9,..., r(n+7) and popr restores them, pushv stores all volatile registers (rO,..., r7, bO,..., b3, iO,..., 
i3). popv restores them. 

LIBRARY 

libpG.a 

DIAGNOSTICS 

All routines commonly return 0. The push routines return a negative value in acc if there is no more space. 
The pop routines breakpoint if they are called in the wrong order. The push routines leave indicator flags 
on the stack, and the pop routines verify the flags before touching the stack. Continuing from the break¬ 
point in a pop routine will result in a negative exit from that routine. 


- initialize the register stacking mechanism 

- save and restore base registers from scratchpad stack 

- save and restore index registers from scratchpad stack 

- save and restore ALU registers from scratchpad stack 

- save and restore all volatile registers from scratchpad stack 
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NAME 

libpip - introduction to the Pixar image processing library 

DESCRIPTION 

libpip is a library of Chap routines for performing common image processing tasks. Included are routines 
to perform 1-dimensional and 2-dimensional convolution, box filtering, image arithmetic, histograms and 
find minimum and maximum image values. 


LIBRARY 

/usr/pixar/chap/lib/libpip.a 
SEE ALSO 

intro(3C), libcolor(3C), libpG(3C), libpm(3C), libpt(3C), libpx(3C) 

Description 


LIST OF FUNCTIONS 

Name 

Page 

PWAdd, PWSub, PWMul, PWDiv 

PWArithmetic(3C) 

PWBBox 

PWBBox(3c) 

PWBoxFilterX, PWBoxFilterY 

PWBoxFilter(3C) 

PWConvX, PWConvY 

PWConv(3C) 

PWCrc 

PWCrc(3C) 

PWHistogram 

PWHistogram(3Q 

PWMap 

PWMap(3C) 

PWRange 

PWRange(3C) 

PWc33 

PWc33(3C) 

PWc33s 

PWc33s(3C) 

SSAdd, SSSub, SSMul, SSDiv 

SSArithmetic(3C) 

SSBoxFilter 

SSBoxFilter(3C) 

SSConv 

SSConv(3C) 

SSCrc 

SSCrc(3C) 

SSRange 

SSRange(3C) 

c33 

c33(3C) 

c33s 

c33s(3C) 

c55s 

c55s(3C) 

cdhg 

dhg(3C) 

idhg 

dhg(3C) 


- add, subtract, multiply and divide scratchpad arrays 

- determine the smallest rectangle that surrounds an image 

- convolve pixel window buffer with 1-d pulse (box) 

- convolve pixel window with a 1-d kernel 

- performs a Cyclic Redundency Check (CRC) on a pixel window 

- compute the histogram of a pixel window 

- map a single component through a color table 

- find the minimum and maximum values in a pixel window 

- convolve pixel window with 3x3 filter 

- convolve pixel window with 3x3 separable filter 

- add, subtract, multiply and divide scratchpad arrays 

- convolve scratchpad buffer with 1-d pulse (box) 

- convolve scratchpad buffer with 1-d kernel 

- performs Cyclic Redundency Check on scanline in scratchpad 

- find minimum and maximum values in a scratchpad array 

- convolve scratchpad buffers with 3x3 kernel 

- convolve scratchpad buffers with 3x3 separable kernel 

- convolve scratchpad buffers with 5x5 separable kernel 

- accumulate histogram of input component array 

- accumulate histogram of input integer array 


Release 1.2 


November 25,1986 
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NAME 

c33 - convolve scratchpad buffers with 3x3 kernel 

SYNOPSIS 

c33( src, dst, kernel, n, spadbuffer ) 

pixel **src, **dst; 

int kernel[3][3]; 

register n; 

index **spadbuffer; 

DESCRIPTION 

c33 convolves 3 scanlines stored in scratchpad memory with a 3x3 kernel and stores the result in scrathpad 
memory. 

This procedure is designed to be called once per scanline (see for example, PWc33) so it needs to maintain 
a ring of scratchpad buffers. The 3 input buffers each have n+2 pixels and the output buffer has n pixels. 
The two extra pixels in the input buffers are used as padding and are normally filled with Os. The index 
register spadbuffer is a pointer to an two entry array of pixel pointers. The first entry is the oldest 
scratchpad array and the second is the second oldest. Each time it is called the ring of buffers is cycled so 
that the spadbuffer[0] = spadbuffer[l], spadbuffer[l] = *src and *src = spadbuffer[0]. These input pointers 
point to the first real pixel, not the padded pixel. 

kernel points to 9 11-bit coefficients that comprise the 3x3 kernel matrix. The first three entries in the 
matrix correspond to the oldest scanline, the next three to the second oldest scanline and the final three 
entries to the src scanline. 

TIMING 

The inner loop takes 19 ticks per pixel. 

LIBRARY 

libpip.a 

SEE ALSO 

PWc33(3C), PWc33s(3C), c33s(3C), c55s(3Q, PWConv(3C) 


Release 1.2 
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NAME 

c33s - convolve scratchpad buffers with 3x3 separable kernel 

SYNOPSIS 

c33s( src, dst, kernel, n, spadbuffer ) 

pixel **src, **dst; 

int kernei[6]; 

register n; 

index ♦’"spadbuffer; 

DESCRIPTION 

c33s convolves 3 scanlines stored in scratchpad memory with a 3x3 separable kernel and stores the result 
in scrathpad memory. 

This procedure is designed to be called once per scanline (see for example, PWc33) so it needs to maintain 
a ring of scratchpad buffers. The 3 input buffers each have n+2 pixels and the output buffer has n pixels. 
The two extra pixels in the input buffers are used as padding and are normally filled with Os. The index 
register spadbuffer is a pointer to a two entry array of pixel pointers. The first entry is the oldest scratchpad 
array and the second is the second oldest. Each time it is called the ring of buffers is cycled so that the 
spadbuffer[0] = spadbufferfl], spadbuffer[l] = *src and *src = spadbuffer[0]. These input pointers point to 
the first real pixel, not the padded pixel. 

kernel points to 6 11-bit coefficients that comprise the horizontal and vertical 3 entry kernel matrices. The 
first three entries in the matrix correspond to the horizontal filter, the next three to the vertical filter. 

TIMING 

The inner loop takes 14 ticks per pixel. 

LIBRARY 

libpip.a 

SEE ALSO 

c33s(3C), c55s(3C), PWConv(3C) 


Release 1.2 
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NAME 

c55s - convolve scratchpad buffers with 5x5 separable kernel 

SYNOPSIS 

c55s( src, dst, kernel, n, spadbuffer ) 

pixel **src, **dst; 

int kernel[10]; 

register n; 

index **spadbuffer; 

DESCRIPTION 

c55s convolves 5 scanlines stored in scratchpad memory with a 5x5 separable kernel and stores the result 
in scrathpad memory. 

This procedure is designed to be called once per scanline (see for example, PWc55), so it needs to maintain 
a ring of scratchpad buffers. The 5 input buffers each have n+2 pixels and the output buffer has n pixels. 
The two extra pixels in the input buffers are used as padding and are normally filled with Os. The index 
register spadbuffer is a pointer to a four entry array of pixel pointers. The first entry is the oldest 
scratchpad array, the second is the second oldest, and so forth. Each time it is called, the ring of buffers is 
cycled so that the spadbuffer[ 0] = spadbuffer[ 1], spadbuffer[ 1] = spadbuffer[ 2], spadbuffer[2] = spad- 
buffer[ 3], spadbuffer[3] = *src and *src = spadbuffer[0]. These input pointers point to the first real pixel, 
not the padded pixel. 

kernel points to 10 11-bit coefficients that comprise the horizontal and vertical 5 entry kernel matrices. The 
first five entries in the matrix correspond to the horizontal filter, the next five to the vertical filter. 

LIBRARY 

libpip.a 

SEE ALSO 

c33(3G), c33s(3G), PWConv(3G) 


Release 1.2 
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NAME 

PWAdd, 

PWSub, 

PWMul, 

PWDiv - add, subtract, multiply and divide scratchpad arrays 

SYNOPSIS 

PWAdd( dstpw, srcpw, spadl, spad2 ) 
int *dstpw, *srcpw; 
pixel ♦spadl, *spad2; 

PWSub( dstpw, srcpw, spadl, spad2 ) 
int *dstpw,♦srcpw; 
pixel *spadl, *spad2; 

PWMul( dstpw, srcpw, spadl, spad2 ) 
int *dstpw, *srcpw; 
pixel *spadl, »spad2; 

PWDiv( dstpw, srcpw, spadl, spad2 ) 
int *dstpw,*srcpw; 
pixel *spadl, *spad2; 

DESCRIPTION 

These procedures perform image arithmetic on pixel windows. Pixels values are treated as 11-bit fixed 
point quantities. Therefore, 2048*2048=2048 and 2048/2048=2048. PWAdd sets dstpw += srcpw, PWSub 
sets dstpw -= srcpw, PWMul sets dstpw *= srcpw; and PWDiv sets dstpw /= srcpw. 

LIBRARY 

libpip.a 

SEE ALSO 

SSArithmetic(3C) 
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NAME 

PWBBox - determine the smallest rectangle that surrounds an image 

SYNOPSIS 

PWBBox (pw,background,spad) 

ChadPW *pw; 
pixel background; 
pixel *spad; 

DESCRIPTION 

PWBBox finds the smallest rectangle (bounding box) that surrounds an image in the given pixel window. 
This can be used to make a smaller pixel window so that subsequent processing is performed on smaller 
images and takes less time. 

The color background is used to determine whether the image data is present. If the color equals back¬ 
ground image data is assumed not to be present; if, on the otherhand, the color is not equal to background, 
image data is assumed to be present. Normally, background is set to (0,0,0,0). background is passed by 
value. 

The edges of the bounding rectangle are returned in (xmin, xmax, ymin, ymax) which are packed into R0. 
xnun is stored in the 0th, xmax in the 1st, ymin in the 2nd, and ymax in the 3rd processor. These coordi¬ 
nates are relative to the pixel window. If the entire pixel window contains valid image data, (xmin,ymin) 
will equal (0,0), and (xmax,ymax) will equal the width and height of the pixel window, respectively. 

spad is a scanline buffer which must equal in size to the maximum of the width and heigth of the pixel win¬ 
dow. 

LIBRARY 

libpip.a 

SEE ALSO 

PirlBBox (3H) 
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NAME 

PWBoxFilterX, 

PWBoxFilterY - convolve pixel window buffer with 1-d pulse (box) 

SYNOPSIS 

PWBoxFilterX( pw, spadl, spad2, width, highpass ) 
int *pw; 

pixel *spadl, ♦spadl; 
register width, highpass; 

PWBoxFilterY( pw, spadl, spad2, width, highpass ) 
int *pw; 

pixel *spadl, *spad2; 
register width, highpass; 

DESCRIPTION 

PWBoxFilterX and PWBoxFilterY perform a one-dimensional convolution of the image stored in the pixel 
window. An image can be convolved with a 2-d pulse function by first convolving in X, and then convolv¬ 
ing in Y. 

The convolution is done by summing the center pixel plus the width pixels preceding and following it. 
Therefore, the total width of the pulse is 2*width+l pixels. In the case of the X version, the pixels are 
summed horizontally; in the case of the Y version, vertically. 

If the flag highpass is non-zero, the result of the convolution is subtracted from the value of the center 
pixel. This creates a highpass filter. 

spadl and spad2 are temporary arrays used in scanline processing. They should be equal to at least the 
xsize of the pixel window. 

LIBRARY 

libpip.a 

SEE ALSO 

c33(3C), c55(3C), SSBoxFilter(3C), PWConv(3C) 
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NAME 

PWConvX, 

PWConvY - convolve pixel window with a 1-d kernel 

SYNOPSIS 

PWConvX( pw, kernel, spadl, spad2, kernelsize, offset) 
int *pw; 

pixel *kernel, *spadl, *spad2; 
register kernelsize, offset; 

PWConvY( pw, kernel, spadl, spad2, kernelsize, offset) 
int *pw; 

pixel *kernel, *spadl, *spad2; 
register kernelsize, offset; 

DESCRIPTION 

PWConvX and PWConvY convolve the image in the pixel window with a 1-dimensional kernel. In the X 
version, the kernel extends kernelsize pixels along the x axis. In the Y version, the kernel is aligned with 
the y axis. The result is placed in the same pixel window. 

Each element in the kernel array is a pixel. Thus, each component can be convolved with different kernel 
weights. 

If the kernel values have 11 bits of fraction, the result will also have 11 bits of fraction. 

The variable offset specifies which entry of the kernel matrix corresponds to the center pixel. If offset is 0, 
the last entry of the kernel is aligned with the pixel being output. If offset is width/2, the kernel is centered. 

spadl and spadl are two buffers used for scanline processing, spadl should be equal to the xsize of the 
window; spadl should be equal to the xsize of the window plus the kernelsize-1 . 

LIBRARY 

libpip.a 

SEE ALSO 

c33(3C), c55(3Q, SSConv(3C) 


Release 1.2 


November 25,1986 


1 



PWCRC (3C) 


Pixar Programmer’s Manual 


PWCRC (3C) 


NAME 

PWCrc - performs a Cyclic Redundency Check (CRC) on a pixel window 

SYNOPSIS 

PWCrc(pw,spad) 
int *pw; 
pixel *spad; 

DESCRIPTION 

SSCrc computes a CCITT standard CRC value for pw. 

The spad buffer is equal to the width of the pixel window in pixels. 

DIAGNOSTICS 

The crc value is returned in rO. 

LIBRARY 

libpip.a 

SEE ALSO 

SSCrc(3C), PirlCrc(3H), crc(lH), PW(3C), TB(3C) 


Release 1.2 
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NAME 

PWHistogram - compute the histogram of a pixel window 

SYNOPSIS 

PWHistogram( pw, histogram, size, component, spad ) 
int *pw; 

pixel *histogram; 
register size, component; 
pixel *spad; 

DESCRIPTION 

PWHistogram computes a frequency histogram of one component within a pixel window (pw). size is the 
total number of bins in the histogram array. Each entry in the histogram array is a double precision integer 
(32-bits). Therefore, the histogram array itself occupies 2*size words of scratchpad memory, component 
is an integer in the range 0-3 that specifies whether the red, green, blue or alpha component is tabulated. 

Since pixels are signed numbers, 0 is stored at location histogram[size/4] and pixel 1 is stored at location 
histogram[size/4+size/2 ]. 

spad is a buffer of pixels used for scanline processing. It should be equal to the xsize of the pixel window. 
LIBRARY 

libpip.a 

SEE ALSO 

dhg(3C), SSRange(3C), PWRange(3C) 


Release 1.2 


July 1,1986 
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NAME 

PWMap - map a single component through a color table to form a color image 

SYNOPSIS 

PWMap(pwsrc, dstpw, chan, map, spada, spadb) 

PW *pwsrc, *dstpw; 
pixel *map; 
pixel *spada, *spadb; 
int chan; 

DESCRIPTION 

PWMap creates a color image from a single channel image by using the value in the single channel image 
as in index into a color table. The given component, chan , which must be a number from 0 to 3 (represent¬ 
ing red through alpha) of the image stored in the source pixel window, pwsrc, are mapped and written to 
the destination pixel window, pwdst. 

The map table is actually four tables: TR, TG, TB, TA. The map table should point to the untesselated 4- 
way value TR[0], TG[0], TB[0], TA[0]. The component value from the source pixel is looked up in each 
table and then written to the pwdst. Note that if the pixels contain negative values (and pixel values may be 
negative), the table should extend not only forward in scratchpad memory from the map table, but also 
backwards. 

LIBRARY 

libpta 

SEE ALSO 

PirlMapComp(3H), PirlMap(3H), PirlMakeMap(3H), PirlCha(3H) 

SS4Map(3C), PWMap(3C) 

SSRtoRGBALUT(3C), SSGtoRGBALUT(3C), SSBtoRGBALUT(3C), SSAtoRGBALUT(3C) 


Release 1.2 
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NAME 

PWRange - find the minimum and maximum values in a pixel window 

SYNOPSIS 

PWRange( pw, min, max, spad ) 
in *pw; 

pixel *min, *max; 
pixel *spad; 

DESCRIPTION 

PWRange finds the minimum and maximum values within a pixel window. These are returned in 
scratchpad locations pointed to by nun and max. Unlike SSRange, min and max need not be initialized. 

spad is a buffer of pixels used for scanline processing. It should be equal to the xsize of the pixel window. 
LIBRARY 

libpip.a 

SEE ALSO 

SSRange(3C), PWHistogram(3C) 


Release 1.2 


July 1,1986 
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NAME 

PWc33 - convolve pixel window with 3x3 filter 

SYNOPSIS 

PWc33( pw, kernel, spadl, spad2, spad3, spad4 ) 

int *pw; 

int kernel[3][3]; 

pixel *spadl, *spad2, *spad3, *spad4; 

DESCRIPTION 

PWc33 convolves images stored in the framebuffer with a 3x3 filter and stores it in the same pixel window. 

kernel points to 9 11-bit coefficients that comprise the 3x3 kernel matrix. The first three entries in the 
matrix correspond to the oldest scanline, the next three to the second oldest scanline and the final three 
entries to the src scanline. 

spadl, spad2 , and spad3 are temporary arrays used in scanline processing. They should be equal to at 
least the xsize of the pixel window plus 2. spad4 should have at least xsize pixels. 

LIBRARY 

libpip.a 

SEE ALSO 

PWc33s(3C), c33(3C), c55(3C), SSBoxFilter(3C), PWConv(3C) 


Release 1.2 


July 1,1986 
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NAME 

PWc33s - convolve pixel window with 3x3 separable filter 

SYNOPSIS 

PWc33s( pw, kernel, spadl, spad2, spad3, spad4 ) 

int *pw; 

int kernel [6]; 

pixel *spadl, *spad2, *spad3, *spad4; 

DESCRIPTION 

PWc33s convolves images stored in the framebuffer with a 3x3 filter and stores it in the same pixel win¬ 
dow. 

kernel points to 6 11-bit coefficients that comprise the horizontal and vertical 3 entry kernel matrices. The 
first three entries in the matrix correspond to the horizontal filter, the next three to the vertical filter. 

spadl , spadl , and spad3 are temporary arrays used in scanline processing. They should be equal to at 
least the xsize of the pixel window plus 2. spad4 should have at least xsize pixels. 

LIBRARY 

libpip.a 

SEE ALSO 

PWc33(3C), c33s(3C), c55(3C), SSBoxFilter(3C), PWConv(3C) 


Release 1.2 


July 1,1986 
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NAME 

SSAdd, 

SSSub, 

SSMul, 

SSDiv - add, subtract, multiply and divide scratchpad arrays 

SYNOPSIS 

SSAdd( a, b, c, n ) 
pixel *a, *b, *c; 
register n; 

SSSub( a, b, c, n ) 
pixel *a, *b, *c; 
register n; 

SSMul( a, b, c, n ) 
pixel *a, *b, *c; 
register n; 

SSDiv( a, b, c, n ) 
pixel *a, *b, *c; 
register n 

DESCRIPTION 

These procedures perform vector arithmetic on arrays of pixels stored in scratchpad memory. Pixels values 
are treated as 11-bit fixed point quantities. Therefore, 2048*2048=2048 and 2048/2048=2048. The arrays 
are all n pixels long. SSAdd sets c=a+b\ SSSub sets c~a-b\ SSMul sets c-a*b; and SSDiv sets c-alb. 

TIMING 

SSAdd and SSSub take 4 ticks per element. SSMul takes 5 ticks per element. SSDiv takes approximately 
150 ticks (it calls reciprocal^ C) at each pixel) per element. 

LIBRARY 

libpip.a 

SEE ALSO 

PWArithmetic(3C) 
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NAME 

SSBoxFilter - convolve scratchpad buffer with 1-d pulse (box) 

SYNOPSIS 

SSBoxFilter( src, dst, n, width, divwidth, highpass ) 
pixel *src, *dst; 

register n, width, divwidth, highpass; 

DESCRIPTION 

SSBoxFilter performs a one-dimensional convolution between the src and a box filter or pulse function. 
The pulse function is centered at each pixel of the src array. The value of each pixel in the dst army is 
equal to the sum of the center pixel plus the width pixels preceding and following the center pixel in the 
scratchpad array. Therefore, the total width of the pulse is 2*width+l pixels. 

If the flag highpass is non-zero, the result of the convolution is subtracted from the value of the center 
pixel. This creates a highpass filter. 

After the sum is computed, it is divided by divwidth. Normally, divwidth is equal to 2*width+l. 

TIMING 

The inner loop takes 7 ticks per pixel. 

LIBRARY 

libpip.a 

SEE ALSO 

c33(3C), c55(3C), PWBoxFilter(3C), SSConv(3C) 


Release 1.2 
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NAME 

SSConv, SSConv2, SSConv4 - convolve scratchpad buffer with 1-d kernel 

SYNOPSIS 

SSConv( src, kernel, dst, n, kernelsize ) 
pixel *src, *kernel, *dst; 
register n, kernelsize; 

SSConv2( src, dst, n, a, b ) 
pixel *src, *dst; 
register n, a, b; 

SSConv4( src, dst, kernel, n ) 
pixel *src, *dst, *kernel; 
register n; 

DESCRIPTION 

SSConv performs a one-dimensional convolution between the src and the kernel. The src is 
(n+kernelsize+l) pixels long. The result is placed in dst, which must be n pixels long. The first result ir 
the destination buffer results from first element of the kernel being aligned with the first entry in the source 
buffer. The last result in the destination buffer is calculated with the first element of the kernel being 
aligned with the nth element of the source. 

Each element in the kernel array is a pixel. Thus, each component can be convolved with different kernel 
weights. 

If both the src and kernel values have 11 bits of fraction, the dst values will also have 11 bits of fraction. 

SSConv2 is an optimized verstion for convolutions of length 2. dst[i] is equal to a*src[i] + b*src[i+l]. 

SSConv4 is an optimized version for convolutions of length 4. dst[i] is equal to a*src[i] + b*src[i+lj + 
c*src[i+2] + d*src[i+3] where a , b, c and d are the coefficients pointed to by kernel. 

LIBRARY 

libpip.a 

SEE ALSO 

c33(3C), c55(3C), PWConv(3C) 
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NAME 

SSCrc - performs a Cyclic Redundency Check (CRC) on a scanline in scratchpad 

SYNOPSIS 

SSCrc(src,crc_value, n) 
pixel *src, register crc_value, n; 

DESCRIPTION 

SSCrc performs a CRC on n pixels in scratchpad using the passed crc_value as the initial seed. The 
crc_value is updated upon completion. The coeficients used for the check are those found in the CCITT 
standard. The recommended initital seed value is Oxffff. 

LIBRARY 

libpip.a 

SEE ALSO 

PWCrc(3C), PirlCrc(3H), crc(lH), PW(3C), TB(3C) 

DIAGNOSTICS 

The updated crc value is returned in rO. 
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NAME 

SSRange - find the minimum and maximum values in a scratchpad array 

SYNOPSIS 

SSRange( src, n, min, max ) 

pixel *src; 

register n; 

pixel *min, *max; 

DESCRIPTION 

SSRange tests each component of each pixel in scratchpad memory whether it is less than min or greater 
than max and then updates min and max , respectively. To test for the actual minimum and maximum 
values stored in a scratchpad array, min and max should be initialized to 1.5E (3071) and -0.5E (-1024), 
respectively. 

LIBRARY 

libpip.a 

SEE ALSO 

PWRange(3C), PWHistogram(3C) 
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NAME 

idhg - accumulate histogram of input integer array 

cdhg - accumulate histogram of input component array 

SYNOPSIS 

idhg(icount,hcount,iptr,hptr) 
register icount,hcount; 
int *iptr; 
double *hptr; 

cdhg(icount,hcount,iptr,hptr) 
register icount,hcount; 
component *iptr; 
double *hptr; 

DESCRIPTION 

idhg takes an integer array pointed to by iptr and accumulates into a histogam table pointed to by hptr. 
There are icount elements of the input array and hcount elements of the histogram array. The routine 
assumes that 11-bit values are being examined; they are rescaled to fit into the hcount accumulators of the 
histogram array. Note that hptr points to H[0]; negative indices will accumulate into histogram values pre¬ 
vious to H[0]. Input values outside the range [-0.5E,1.5E) will increment values outside the histogram 
array. 

cdhg is very similar, except that the input values are assumed to be from a single component of a 
scratchpad pixel array. 

LIBRARY 

libpG.a 
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NAME 

libpm — introduction to Pixar arithmetic library 

DESCRIPTION 

libpm provides functions for performing common arithmetic operations using the Chap. These include 
extended precision arithmetic (xp( 3C)), reciprocals (reciprocal 3C)), square roots (sqrt( 3C)), reciprocals of 
square roots ( recsqrt(2>C)), random number generation ( rrand(3C )), and matrix multiplication (matrix( 3C)). 

LIBRARY 

/usr/pixar/chap/lib/libpm.a 
SEE ALSO 

intro(3C), libcolor(3C), libpG(3C), libpip(3C), libpt(3C), libpx(3C) 
matrix(3C), reciprocal(3C), recsqrt(3C), rrand(3C), sqrt(3C), xp(3C) 

LIST OF FUNCTIONS 


Name 

Page 

Description 

XPXIcopy22 xp(3C) 

- double_pixel -> double_pixel 

XPabs22 

xp(3C) 

- abs(double_pixel) -> double_pixel 

XPadd222 

xp(3C) 

- double_pixel+double_pixel -> double_pixel 

XPadd333 

xp(3C) 

- triple_pixel+triple_pixel -> triplejpixel 

XPadd444 

xp(3C) 

- quad_pixel+quad_pixel -> quad_pixel 

XPcopy22 

xp(3C) 

- double_pixel -> double_pixel 

XPcopy33 

xp(3C) 

- triple_pixel -> triple_pixel 

XPcopy44 

xp(3C) 

- quad_pixel -> quad_pixel 

XPdiv224 

xp(3C) 

- double_pixel/double_pixel -> quad_pixel 


XPmultl 12 xp(3C) - pixel*pixel -> doublejpixel 

XPmult222 xp(3C) - pixel*pixel -> double_pixel 

XPmult224 xp(3C) - double_pixel*double_pixel -> quad_pixel 

XPneg22 xp(3Q - -doublejpixel -> double_pixel 

XPread22 xp(3C) - double_pixel -> register double_pixel 

XPread33 xp(3C) - triple_pixel -> register triple_pixel 

XPread44 xp(3C) - quad_pixel -> register quad_pixel 

XPrec22 xp(3C) - l/double_pixel -> doublejpixel 

XPsub222 xp(3C) - double_pixel-double_pixel -> double_pixel 

XPsub333 xp(3C) - triple_pixel-triple_pixel -> triple_pixel 

XPsub444 xp(3C) - quad_pixel-quad_pixel -> quad_pixel 

XPwrite22 xp(3C) - register double_pixel -> double_pixel 

XPwrite33 xp(3C) - register triple_pixel -> triple_pixel 

XPwrite44 xp<3C) - register quad_pixel -> quad_pixel 

frecsqrt321 recsqrt(3C) - compute approximate 4-way reciprocal square root of 

unsigned 32-bit double-precision fraction 

fsqrt321 sqrt(3C) - compute approximate 4-way square root of unsigned 32-bit double-precision 

fraction 

isqrt321 sqrt(3C) - compute approximate 4-way square root of unsigned 32-bit integer 

matmull6 matrix(3C) - multiply two 4x4 matrices of 16-bit integers 

matmul32 matrix(3C) - multiply two 4x4 matrices of double-precision fractions 

matvec32 matrix(3C) - multiply a double-precision vector list by a double-precision matrix 

reciprocal reciprocal(3C) - computes 2‘16/n of four 16-bit numbers 

reciprocal32 reciprocal(3C) - computes 2~32/n of four non-negative 32-bit numbers 

recsqrtl61 recsqrt(3C) - compute approximate 4-way reciprocal square root of unsigned 16-bit fraction 

recsqrt321 recsqrt(3C) - compute approximate 4-way reciprocal square root of unsigned 32-bit fraction 

rrand rrand(3Q - produce 4 random numbers 

sqrtl6 sqrt(3C) - compute exact 4-way square root of unsigned 16-bit fraction 

sqrtl61 sqrt(3C) - compute approximate 4-way square root of unsigned 16-bit fraction 
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NAME 

matmull6 
matmul32 
matvec32 

SYNOPSIS 

matmull6(m0, ml, m2) 
pixel *m0, *ml, *m2; 

matmul32(m0_lsp, mO msp, ml lsp, ml msp, m2_lsp, m2_msp) 
pixel *mO_lsp, *mO_msp, *ml_lsp, *ml_msp, *m2_lsp, *m2_msp; 

matvec32(length, vin_Isp, vin_msp, mat_lsp, mat_msp, voutlsp, vout_msp) 
register length; 

pixel *vin_lsp, *vin_msp, *mat_Isp, *mat_msp, *vout_lsp, *vout_msp; 

DESCRIPTION 

All these routines operate on matrices stored in “row-column” order. Double-precision matrices and vec¬ 
tor lists are stored in two parts, so that all the Isp data is in one array and all the msp data in another. This 
is done to take advantage of the 4-way parallelism of the Chap. Similar considerations cause vector lists to 
be “row vectors”; matrices act on these vectors on the right. 

matmull6 performs the matrix multiplication: m2 = mO*ml , where the matrices are composed of 16-bit 
integer entries, m2 may be the same address as mO or ml . 

matmul32 performs the matrix multiplication: m2 = mO*ml , where the matrices are composed of 32-bit 
double-precision fractions. As noted above, the low and high order parts of the entries are stored in 
separate arrays, m2 may be the same address as either of the inputs. 

matvec32 multiplies the input vector list vin on the right by the matrix mat, and puts the resulting vectors 
into the list vout. As noted above, the low and high order parts of the entries are stored in separate arrays. 
The number of vectors processed is a multiple of 4; it is defined to be the smallest multiple of 4 containing 
length. NOTE: When allocating vector lists, make sure they are aligned on 4-vector boundaries. 

TIMING 

matmull6: "100 ticks 

matmul32: ~550 ticks 

matvec32: “112 ticks/vector 

LIBRARY 

libpm.a 


- multiply two 4x4 matrices of 16-bit integers 

- multiply two 4x4 matrices of double-precision fractions 

- multiply a double-precision vector list by a double-precision matrix 
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NAME 

reciprocal - computes 2~16/n of four 16-bit numbers 

reciprocal32 - computes 2*32/n of four non-negative 32-bit numbers 

SYNOPSIS 

reciprocal^, recip) 
register n, recip; 

reciprocaI32(n_lsp, n_msp, reciprocal_Isp, reciprocal_msp) 
register n_lsp, n_msp, reciprocal_lsp, reciprocal_msp; 

DESCRIPTION 

reciprocal computes 2*16/n for four numbers in rO and returns the result in rl. 

An 8-bit approximation is found via a lookup table. Newton’s method is used to get 16 bits of precision 
timing. Execution ranges from 58-71 ticks. 

reciprocal computes the 2'32/n for four numbers whose least significant parts are in rO and most 
significant parts are in rl. The resulting lsps are returned in r2, the msps in r3. 

An 8 bit approximation is found via a lookup table. Newton’s method is used to get 32 bits of precision. 

TIMING 

Execution ranges from 120-194 ticks: 

all msps > 0: 122-142 ticks 

all msps = 0: 120-142 ticks 

some msps > 0, some = 0: 154-194 ticks 

LIBRARY 

libpm.a 

BUGS 

The routine only accepts non-negative inputs. 


Release 1.2 


July 17,1986 


1 



RECSQRT (3C) 


Pixar Programmer’s Manual 


RECSQRT (3C) 


NAME 

recsqrtl61 - compute approximate 4-way reciprocal square root of unsigned 16-bit fraction 

recsqrt321 - compute approximate 4-way reciprocal square root of unsigned 32-bit fraction 

frecsqrt321 - compute approximate 4-way reciprocal square root of unsigned 32-bit 

double-precision fraction 

SYNOPSIS 

recsqrtl61(x,sx) 
register x, sx; 

recsqrt321(x_lsp, xjmsp, sx) 
register x_lsp, x_msp, sx; 

frecsqrt32I(x_Isp, x_msp, sx_lsp, sx_msp) 
register x lsp, xjmsp, sx lsp, sx msp; 

DESCRIPTION 

recsqrtl6l uses an 8-bit lookup table followed by linear interpolation to compute the approximate recipro¬ 
cal square root of the unsigned 16-bit integer in x. It returns a result in sx, such that x*sx*sx = (1 « 16). 
The result is accurate to within 1 part in 10000. 

recsqrt32l uses sqrtl6l to compute an approximate square root of the unsigned 32-bit number contained in 
x_lsp and xjnsp. It returns a 16-bit result in sx. The input should be thought of as a pure unsigned frac¬ 
tion of unity, and the output as a pure unsigned integer (or vice-versa). 

frecsqrt32l uses sqrtl6l to compute an approximate square root of the unsigned 32-bit double-precision 
fraction in xjsp and xjnsp. It returns a result in sx lsp and sxjnsp. Both input and output should be 
thought of as (16,16) unsigned fractions, that is, each contains 16 bits of integer and 16 fractional bits. 

TIMING 

The 16-bit routine runs in about 70 ticks; the 32-bit routines in about 100. 

LIBRARY 

libpm.a 
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NAME 

irand - produce 4 random numbers 

SYNOPSIS 

rrand() 

saverrand(s56) 
int *s56; 

restorerrand(s56) 
int *s56; 

DESCRIPTION 

rrand produces four random numbers in acc. Knuth’s additive random number generator is used. Execu¬ 
tion timing is 29 ticks. 

saverrand expects a pointer, in s56, to 56 pixels of scratchpad space. The current state of the random 
number generator is stored there, restorerrand expects a pointer in bO to 56 pixels of scratchpad space into 
which the random number generator state has been stored. The random number generator is restored to 
that state. 

LIBRARY 

libpm.a 

DIAGNOSTICS 

saverrand returns —1 in acc if the random number generator has been corrupted, restorerrand returns —1 in 
acc if the 56 locations of scratchpad do not hold a valid random number generator state. Both routines 
return 0 upon success. 
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NAME 

sqrtl6 - compute exact 4-way square root of unsigned 16-bit fraction 

sqrtl61 - compute approximate 4-way square root of unsigned 16-bit fraction 

fsqrt321 - compute approximate 4-way square root of unsigned 32-bit double-precision 

fraction 

isqrt321 - compute approximate 4-way square root of unsigned 32-bit integer 

SYNOPSIS 

sqrtl6(x,sx) 
register x, sx; 

sqrtl61(x,sx) 
register x, sx; 

fsqrt321(x_lsp, xjmsp, sxjsp, sx_msp) 
register xlsp, x_msp, sx_Isp, sxmsp; 

isqrt321(x_lsp, x_msp, sx) 
register x_lsp, xmsp, sx; 

DESCRIPTION 

sqrtl6 computes the exact square root of the unsigned 16-bit fraction in x and returns a result of the same 
type in sx. It generates one bit at a time by guessing. 

sqrtl6l uses an 8-bit lookup table followed by linear interpolation to compute the approximate square root 
of the unsigned 16-bit fraction in x. It returns a result of the same type in rl. The result is accurate to 
within 1 part in 10000. 

fsqrt32l uses sqrtl6l to compute an approximate square root of the unsigned 32-bit double-precision frac¬ 
tion in xjsp and xjnsp. It returns a result of the same type in sxjsp and sxjnsp. 

isqrt32l uses sqrtl6l to compute an approximate square root of the unsigned 32-bit integer contained in 
xjsp and xjnsp . It returns a 16-bit result in sx . 

TIMING 

Execution time of sqrtl6 is about 460 ticks; sqrtl6l, about 70 ticks. The 32-bit routines require about 90 
ticks. 

LIBRARY 

libpm.a 
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NAME 


XPneg22 

- -double_pixel -> double_pixel 

XPabs22 

- abs(double_pixel) -> double_pixel 

XPrec22 

- l/double_pixel -> double_pixel 

XPXIcopy22 

- doublejpixel -> double_pixel 

XPcopy22 

- doublejpixel -> double_pixel 

XPcopy33 

- triple_pixel -> triple_pixel 

XPcopy44 

- quad_pixel -> quad_pixel 

XPadd222 

- double_pixel+double_pixel -> double_pixel 

XPadd333 

- triplej>ixel+triplej)ixel -> triple_pixel 

XPadd444 

- quadjpixel+quad_pixel -> quad_pixel 

XPsub222 

- doublejpixel-double_pixel -> double_pixel 

XPsub333 

- triplejpixel-triplejiixel -> triple_pixel 

XPsub444 

- quad_pixel-quad_pixel -> quad_pixel 

XPmultll2 

- pixel *pixel -> doublej>ixel 

XPmult222 

- pixel*pixel -> double_pixel 

XPmult224 

- doublejpixel*doublej)ixel -> quad_pixel 

XPdiv224 

- double_pixel/double_pixel -> quad_pixel 

XPread22 

- double_pixel -> register double_pixel 

XPread33 

- triple_pixel -> register triple_pixel 

XPread44 

- quad_pixel -> register quad_pixel 

XPwrite22 

- register doublejpixel -> doublejpixel 

XPwrite33 

- register triple_pixel -> triplejpixel 

XPwrite44 

- register quad j>ixel -> quad j>ixel 


SYNOPSIS 

XPneg22(s,t) 

base double_pixel 

XPabs22(s,t) 

base doublejpixel *s,*t; 

XPrec22(s,t) 

base double_pixel *s,*t; 

XPcopy22(s,t) 
base doublejpixel 

XPXIcopy22(s,t) 

base doublejpixel *s; 
base int *t; 

XPcopy33(s,t) 
base triplejpixel *s,*t; 

XPcopy44(s,t) 
base quad_pixel *s,*t; 

XPadd222(sO,sl,t) 

base doublejpixel *sO,*sl,*t; 

XPadd333(sO,sl,t) 
base triplejpixel *s0,*sl,*t; 

XPadd444(sO,sl,t) 
base quadjpixel *sO,*sl,*t; 

XPsub222(sO,sl,t) 

base doublejpixel *sO,*sl,*t; 
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XPsub333(sO,sl,t) 
base triple_pixel *sO,*sl,*t; 

XPsub444(sO,sl,t) 
base quadjpixel *sO,*sl,*t; 

XPmultll2(sO,sl,t) 
base int *sO,*sl; 
base double_pixel *t; 

XPmult222(sO,sl,t) 
base double_pixeI *sO,*sl; 
base doublejpixel *t; 

XPmult224(sO,sl,t) 

base doublejpixel *sO,*sl; 
base quad_pixel *t; 

XPdiv224(sO,sl,t) 

base doublejpixel *sO,*sl; 
base quadjpixel *t; 

XPread22(s) 
base doublejpixel *s; 

XPread33(s) 
base triplejpixel *s; 

XPread44(s) 
base doublejpixel *s; 

XPwrite22(t) 
base doublejpixel *t; 

XPwrite33(t) 
base triplejpixel *t; 

XPwrite44(t) 
base quadjpixel *t; 

DESCRIPTION 

These routines do extended precision arithmetic on pixels (4-way vectors). Double__pixels are stored in 
scratchpad as [rL, gL, bL, aL, rH, gH, bH, aH], so that the four lower-16-bit quantities precede the four 
higher-16-bit quantities. Triples and quads are stored likewise. The storage must be aligned (like all pix¬ 
els) to start at a 4-word boundary. Each set of four can be accessed in standard pixel mode addressing. 

XPrec22 computes the reciprocal of s and writes the result to t. 

XPXIcopy22 copies the double_pixel at s into an integer array t. [rL, gL, bL, aL, rH, gH, bH, aH] is copied 
to [rL, rH, gL, gH, bL, bH, aL, aH]. 

XPcopy22 copies the double_pixel at s into t. 

XPcopy33 copies the triple jpixel at s into t. 

XPcopy44 copies the quad jpixel at s into t. 

XPadd222 adds the double jpixels sO and si and puts the sum in t. 

XPadd333 adds the triple jpixels sO and si and puts the sum in t. 

XPadd444 adds the quad jjixels sO and si and puts the sum in t. 

XPsub222 subtracts the double_pixel at si from the double_pixel at sO and puts the difference in t. 
XPsub333 subtracts the triple_pixel at si from the triplejjixel at sO and puts the difference in t. 
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XPsub444 subtracts the quad_pixel at si from the quad_pixel at sO and puts the difference in t. 

XPmultll2 multiplies the 16-bit quantity at sO by the 16-bit quantity at si and puts the product at t. The 
number of fractional bits of the product will be the sum of the number of fractional bits of the inputs. 

XPmult224 multiplies the double_pixel at sO by the double_pixel -at si and puts the quad_pixel product at t. 
The number of fractional bits of the product will be the sum of the number of fractional bits of the inputs. 

XPmult222 multiplies the double_pixel at sO by the double_pixel at si and puts only the middle 32 bits of 
the quad_pixel product at t. The number of fractional bits of the product will be 16 less than the sum of the 
number of fractional bits of the inputs. 

XPdiv224 divides the double_pixel at sO by the double_pixel at si to produce the quadj>ixel at t. The 
number of fractional bits of the product will be 32 greater than the difference of the number of fractional 
bits of the numerator minus denominator. 

XPread22 copies the double_pixel at s to registers (rl, rO). 

XPread33 copies the triple_pixel at s to registers (r2, rl, rO). 

XPread44 copies the quad_pixel at s to registers (r3, r2, rl, rO). 

XPwrite22 copies the double_pixel stored in registers (rl, rO) to t . 

XPwrite33 copies the triple_pixel stored in registers (r2, rl, rO) to t. 

XPwrite44 copies the quad_pixel stored in registers (r3, r2, rl, rO) to t. 

LIBRARY 

libpm.a 

DIAGNOSTICS 

These routines never return errors. 

These routines never destroy any registers, so there is no need to save the volatile registers before invoking 
the routines. Only acc and il5 are used. 
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NAME 

libpt - introduction to Chap Pixel Transfer Library 

DESCRIPTION 

libpt provides a variety of methods for transfering pixels between the framebuffer and the Chap’s 
scratchpad memory (usually referred to as “scratchpad”). Most useful combinations of pixel transfers are 
accessible through these routines. Each of the routine names is keyed with a letter indicating the type of 
the source and the destination. The rest of the routine name indicates the direction and function of the rou¬ 
tine. 


Although the host interface deals in rectangular windows, the Chap code is scan-line oriented. Each of the 
host routines does multiple calls to the Chap code in order to copy/merge one window. All routines that 
access the framebuffer, either for reading or writing, use pixel windows to specify the area. More detail on 
windows may be found in "man windows", or in the Chap Programming Tutorial. 

A prototypical transfer is SFxCopy. This routine copies one scanline from the scratchpad (designated by 
the “S” in the name SFxCopy ) to the framebuffer memory (the “F”). This routine copies onto a horizon¬ 
tal scanline on the framebuffer (hence the “x”). Similarly, FySCopy copies a vertical scanline from the 
framebuffer to the scratchpad. 


The simple SF and FS transfers are adequate for most operations. Occasionally, a more exotic transfer 
may significantly decrease computation time. This library has routines to copy scanlines in: reverse order, 
runlength encoding, individual channels, etc. 

Library function names follow these conventions: 


Fx 

Fy 

S 

I 

c 

R/G/B/A 

Backwards 


Framebuffer horizontal access 
Framebuffer vertical access 
Scratchpad (tesselated) 

Integer array (copies all four channels - RGBA) 

Channel array (copies only into appropriate channel) 

Red, green, blue and alpha Channels 

copies elements in reverse order (last one to first position) 


LIBRARY 

/usr/pixar/chap/lib/libpLa 


SEE ALSO 

intro(3C), libcolor(3C), libpG(3C), libpip(3C), libpm(3C), libpx(3C) 
LIST OF FUNCTIONS 


Name 

AFxCopy 

AFyCopy 

AllocTB 

BFxCopy 

BFyCopy 

CCCopy 

CFxClear 

CFxCopy 

CFxCopyBackwards 


Page 

RGBAFCopy(3C) 

RGBAFCopy(3C) 

TB(3C) 

RGBAFCopy(3C) 

RGBAFCopy(3C) 

CICopy(3C) 

CFCopy(3C) 

CFCopy(3C) 

CFCopy(3C) 


Description 

- copy component from scratchpad to framebuffer 
in increasing x order 

- copy component from scratchpad to framebuffer 
in increasing y order 

- initializes a tile block in frame buffer memory 

- copy component from scratchpad to framebuffer 
in increasing x order 

- copy component from scratchpad to framebuffer 
in increasing y order 

- copy scratchpad channel aiTay to scratchpad 
channel array 

- clear frame buffer in increasing x order to a com¬ 
ponent value 

- copy component from scratchpad to frame buffer 
in increasing x order 

- copy component from scratchpad to frame buffer 
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in decreasing x order 

CFyClear 

CFCopy(3C) 

- clear frame buffer in increasing x order to a com¬ 
ponent value 

CFyCopy 

CFCopy(3C) 

- copy component from scratchpad to frame buffer 
in increasing y order 

CFyCopyBackwardsy 

CFCopy(3C) 

- copy component from scratchpad to frame buffer 
in decreasing y order 

CICopy 

CICopy(3C) 

- copy scratchpad channel array to scratchpad 
integer array 

CRCopy 

CRCopy(3C) 

- copy scratchpad channel array to runlength array 

ClosePV 

PW(3C) 

- close a pixel volume 

ClosePW 

PW(3C) 

- close a pixel window 

DeallocTB 

TB(3C) 

- deallocates a tile block 

FAxCCopy 

FCCopy(3C) 

- copy scanline from alpha fb channel to spad 
channel array 

FAxCCopyBackwards 

FCCopy(3C) 

- copy scanline from alpha fb channel backwards 
to spad channel array 

FAxICopy 

HCopy(3C) 

- copy scanline from alpha fb channel to spad 
integer array 

FAxICopyBackwards 

FICopy(3C) 

- copy scanline from alpha fb channel backwards 
to spad integer array 

FAyCCopy 

FCCopy(3C) 

- copy vertical scanline from alpha fb channel to 
spad channel array 

FAyCCopyBackwards 

FCCopy(3C) 

- copy vertical scanline backwards from alpha fb 
channel to spad channel array 

FAylCopy 

FlCopy(3C) 

- copy vertical scanline from alpha fb channel to 
spad integer array 

FBxCCopy 

FCCopy(3C) 

- copy scanline from blue fb channel to spad chan¬ 
nel array 

FBxCCopyBackwards 

FCCopy(3C) 

- copy scanline from blue fb channel backwards to 
spad channel array 

FBxICopy 

FICopy(3C) 

- copy scanline from blue fb channel to spad 
integer array 

FBxICopyBackwards 

FICopy(3C) 

- copy scanline from blue fb channel backwards to 
spad integer array 

FByCCopy 

FCCopy(3C) 

- copy vertical scanline from blue fb channel to 
spad channel array 

FByCCopyBackwards 

FCCopy(3C) 

- copy vertical scanline backwards from blue fb 
channel to spad channel array 

FBylCopy 

FICopy(3C) 

- copy vertical scanline from blue fb channel to 
spad integer array 

FBylCopyBackwards 

FICopy(3C) 

- copy vertical scanline backwards from blue fb 
channel to spad integer array 

FBylCopy Backwards 

FICopy(3C) 

- copy vertical scanline backwards from blue fb 
channel to spad integer array 

FFCopy 

TBCopy(3C) 

- copy a single tile between locations in frame 
buffer memory 

FGxCCopy 

FCCopy(3C) 

- copy scanline from green fb channel to spad 
channel array 

FGxCCopyBaekwards 

FCCopy(3C) 

- copy scanline from green fb channel backwards 
to spad channel array 

FGxICopy 

FICqpy(3C) 

- copy scanline from green fb channel to spad 
integer array 
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FGxICopyBackwards 

FICopy(3C) 

FGyCCopy 

FCCopy(3C) 

FGyCCopyBackwards 

FCCopy(3C) 

FGylCopy 

FICopy(3C) 

FGylCopyBackwards 

FICopy(3C) 

FRxCCopy 

FCCopy(3C) 

FRxCCopyBackwards 

FCCopy(3C) 

FRxICopy 

FICopy(3C) 

FRxICopyBackwards 

FICopy(3C) 

FRyCCopy 

FCCopy(3C) 

FRyCCopyBackwards 

FCCopy(3C) 

FRylCopy 

FICopy(3C) 

FRylCopyBackwards 

FICopy(3C) 

FxACopy 

FRGBACopy(3C) 

FxBCopy 

FRGBACopy(3C) 

FxCCopy 

FCCopy(3C) 

FxCCopyBaekwards 

FCCopy(3C) 

FxGCopy 

FRGBACopy(3C) 

FxICopy 

FlCopy(3C) 

FxICopyBackwards 

FICopy(3C) 

FxRCopy 

FRGBACopy(3C) 

FxSCopy 

FSCopy(3C) 

FxSCopyBackwards 

FSCopy(3C) 

FYCopy 

FYCopy(3C) 

FyACopy 

FRGBACopy(3C) 

FyBCopy 

FRGBACopy(3C) 

FyCCopy 

FCCopy(3C) 


- copy scanline from green fb channel backwards 
to spad integer array 

- copy vertical scanline from green fb channel to 
spad channel array 

- copy vertical scanline backwards from green fb 
channel to spad channel array 

- copy vertical scanline from green fb channel to 
spad integer array 

- copy vertical scanline backwards from green fb 
channel to spad integer array 

- copy scanline from red fb channel to spad chan¬ 
nel array 

- copy scanline from red fb channel backwards to 
spad channel array 

- copy scanline from red fb channel to spad integer 
array 

- copy scanline from red fb channel backwards to 
spad integer array 

- copy vertical scanline from red fb channel to 
spad channel array 

- copy vertical scanline backwards from red fb 
channel to spad channel array 

- copy vertical scanline from red fb channel to 
spad integer array 

- copy vertical scanline backwards from red fb 
channel to spad integer array 

- copy scanline from arbitrary fb channel to spad 
channel array 

- copy scanline from arbitrary fb channel to spad 
channel array 

- copy scanline from arbitrary fb channel to spad 
channel array 

- copy scanline from arbitrary fb channel back¬ 
wards to spad channel array 

- copy scanline from arbitrary fb channel to spad 
channel array 

- copy scanline from arbitrary fb channel to spad 
integer array 

- copy scanline from arbitrary fb channel back¬ 
wards to spad integer array 

- copy scanline from arbitrary fb channel to spad 
channel array 

- copy partial scanline from frame buffer to 
scratchpad 

- copy partial scanline from frame buffer back¬ 
wards to scratchpad 

- copy framebuffer to Yapbus 

- copy vertical scanline from arbitrary fb channel 
to spad channel array 

- copy vertical scanline from arbitrary fb channel 
to spad channel array 

- copy vertical scanline from arbitrary fb channel 
to spad channel array 
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FyCCopyBackwards 

FyGCopy 

FylCopy 

FylCopyBackwards 

FyRCopy 

FySCopy 

FySCopyBackwards 

GFxCopy 

GFyCopy 

ICCopy 

IFxClear 

IFxCopy 

IFxCopyBackwards 

IFyClear 

IFyCopy 

IFyCopyBackwards 

IlCopy 

InitPV 

InitPW 

InitTB 

InqPV 

InqPW 

InqTB 

OpenPV 

OpenPW 

PW4Map 

PWAxb 

PWCha 

PWCircularShift 

PWClamp 

PWClear 

PWCopy 

Release 1.2 
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FCCopy(3C) - copy vertical scanline backwards from arbitrary 
fb channel to spad channel array 

FRGBACopy(3C) - copy vertical scanline from arbitrary fb channel 
to spad channel array 

FICopy(3C) - copy vertical scanline from arbitrary fb channel 
to spad integer array 

FICopy(3C) - copy vertical scanline backwards from arbitrary 
fb channel to spad integer array 

FRGBACopy(3C) - copy vertical scanline from arbitrary fb channel 
to spad channel array 

FSCopy(3C) - copy partial vertical scanline from frame buffer 
to scratchpad 

FSCopy(3C) - copy partial vertical scanline backwards from 
frame buffer to scratchpad 

RGBAFCopy(3C) - copy component from scratchpad to frame buffer 
in increasing x order 

RGBAFCopy(3C) - copy component from scratchpad to frame buffer 
in increasing y order 

CICopy(3C) - copy scratchpad integer array to scratchpad 
integer array 


DFCopy(3C) 

IFCopy(3C) 

EFCopy(3C) 

EFCopy(3C) 

IFCopy(3C) 


IFCopy(3C) 

CICopy(3C) 

PW(3C) 

PW(3C) 

TB(3C) 

PW(3C) 

PW(3C) 

TB(3C) 

PW(3C) 

PW(3C) 

PW4Map(3C) 

PWAxb(3C) 


- clear partial scanline using scratchpad integer 
value 

- copy partial scanline from scratchpad integer 
array to frame buffer 

- copy partial scanline backwards from scratchpad 
integer array to frame buffer 

- clear partial vertical scanline using scratchpad 
integer value 

- copy partial vertical scanline from scratchpad 
integer array to frame buffer 

- copy partial vertical scanline backwards from 
scratchpad integer array to frame buffer 

- copy scratchpad integer array to scratchpad 
integer array 

- initialize the pixel volume area 

- initialize the pixel window area 

- cleans out the tile block area 

- provide information about an open pixel volume 

- provide information about an open pixel window 

- gather information on tile block 

- create a pixel volume for frame buffer access 

- create a pixel window for frame buffer access 

- remap 4 components of a pixel window 

- compute new pixel = a*pixol+b for a pixel win¬ 


dow. 


PWCha(3C) 

PWShift(3C) 

PWClamp(3C) 

PWClear(3C) 

PWCopy(3C) 


- perform channel arithmetic on the pixels of a 
pixel window 

- circular shift pixel window contents in x and/or y 

- clamp pixel between 0.0 (0) and 1.0 (0x800) for 
a pixel window 

- clear pixel window to color 

- copy the source pixel window to the destination 
pixel window 
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PWCopyGeneric 

PWCopy(3C) 

PWGeneralSwap 

PWGeneric 

PWSwap(3C) 

PWGeneric(3C) 

PWMerge 

PWNot 

PWMerge(3C) 

PWNot(3Q 

PWShift 

PWShuffle 

PWShift(3C) 

PWShuffle(3C) 

PWSwap 

PWSwap(3C) 

PWTranspose 

PWTranspose(3C) 

RFxCopy 

RGBAFCopy(3C) 

RFxCopy 

RGBAFCopy(3C) 

RSCopy 

ReAllocTB 

ReOpenPW 

SCCopy, SCClear 

SFxClear 

SFxCopy 

RSCopy(3C) 

TB(3C) 

PW(3C) 

SCCopy(3C) 

SFCopy(3C) 

SFCopy(3C) 

SFxCopyRGBA, SFxCopy ARGB, 
SFxCopyBARG, SFxCopyGBAR 
SFxCopyBackwards 

SFCopy(3C) 

SFCopy(3C) 

SFyClear 

SFyCopy 

SFCopy(3C) 

SFCopy(3C) 


- PWCopy with user-specified axes, start and 
direction parameters 

- general purpose implementation of PWSwap. 

- call a spad-to-spad routine for each line of a pixel 
window 

- Merge two pixel windows into a third 

- subtract pixel value from 1.0 (0x800) for a pixel 
window 

- shift pixel window contents in x and/or y 

- shuffle components of each pixel for a pixel win¬ 
dow. 

- swap the source pixel window and the destina¬ 
tion pixel window. 

- transpose a pixel window around the diagonal 
axis. 

- copy component from scratchpad to frame buffer 
in increasing x order 

- copy component from scratchpad to frame buffer 
in increasing x order 

- copy runlength array to scratchpad pixel array 

- reuses a previously allocated tile block 

- create a pixel window for frame buffer access 

- copy (clear) partial scanline in scratchpad 

- clear partial scanline in frame buffer 

- copy partial scanline from scratchpad to frame 
buffer 

- SFxCopy w/ channel rotation 

- copy partial scanline backwards from scratchpad 
to frame buffer 

- clear partial vertical scanline in frame buffer 

- copy partial vertical scanline from scratchpad to 
frame buffer 


SFyCopyRGBA, SFyCopyARGB, 
SFyCopyBARG, SFyCopyGBAR 
SFyCopyBackwards 

SIClear 

SICopy 

SRCopy 

SS4Map 

SSAAAAtoAAAA 

SSAAAAtoBBBB 

SSAAAAtoGGGG 

SSAAAAtoRRRR 

SSAtoRGBA 

SSAtoRGBALUT 

SSBBBBtoAAAA 

SSBBBBtoBBBB 

SSBBBBtoGGGG 

SSBBBBtoRRRR 


SFCopy(3C) 

SFCopy(3C) 

SICopy(3C) 

SICopy(3C) 

RSCopy(3C) 

SS4Map(3C) 

SSCopyComp(3C) 

SSCopyComp(3C) 

SSCopyComp(3C) 

SSCopyComp(3C) 

SSCopyRGBA(3C) 

SSCopyRGBA(3C) 

SSCopyComp(3C) 
SSCopyComp(3C) 
SSCopyComp(3C) 
SSCopyComp(3C) • 


SFyCopy w/ channel rotation 
copy partial vertical scanline backwards from 
scratchpad to frame buffer 
clear an integer array to a single channel value 
copy channels from a pixel array to integer array 
copy scratchpad pixel array to runlength array 
4-way mapping of scratchpad values using a 
mapping table 

Copy one channel to another channel 

Copy one channel to another channel 

Copy one channel to another channel 

Copy one channel to another channel 

Copy one channel from scratchpad to 4 channels 

Copy one channel from scratchpad to 4 channels 

through a color table 

Copy one channel to another channel 

Copy one channel to another channel 

Copy one channel to another channel 

Copy one channel to another channel 


Release 1.2 


November 25,1986 


5 



LIBPT(3C) 


Pixar Programmer’s Manual 


LIBPT (3C) 


SSBtoRGBA 

SSBtoRGBALUT 

SSCha 

SSComb 

SSCompare 

SSCopy, SSClear 

SSGGGGtoAAAA 

SSGGGGtoBBBB 

SSGGGGtoGGGG 

SSGGGGtoRRRR 

SSGtoRGBA 

SSGtoRGBALUT 

SSMerge 

SSMergeAtop 

SSMergeln 

SSMergeOut 

SSMergeOver 

SSMergeUnder 

SSPaint 

SSPaintCopy 

SSPaintOver 

SSRRRRtoAAAA 

SSRRRRtoBBBB 

SSRRRRtoGGGG 

SSRRRRtoRRRR 

SSRtoRGBA 

SSRtoRGBALUT 

SSShuffleBroadcast 

SSShuffleRot 

SSShuffleXbar 

SSaxb 

SYCopy 

SetMaskPW 

YFCopy 

YSCopy 

TBCopy 


SSCopyRGBA(3C)- Copy one channel from scratchpad to 4 channels 
SSCopyRGBA(3C) - Copy one channel from scratchpad to 4 channels 
through a color table 

SSCha(3C) - perform channel arithmetic on the pixels of a 

pixel window 

SSComb(3C) - Combine two images 
SSCompare(3Q - compare scanline pixel buffers in scratchpad 
SSCopy(3C) - copy (clear) partial scanline in scratchpad 
SSCopyComp(3C) - Copy one channel to another channel 
SSCopyComp(3C) - Copy one channel to another channel 
SSCopyComp(3C) - Copy one channel to another channel 
SSCopyComp(3C) - Copy one channel to another channel 
SSCopyRGBA(3C)- Copy one channel from scratchpad to 4 channels 
SSCopyRGB A(3C)- Copy one channel from scratchpad to 4 channels 
through a color table 

SSMerge(3C) - merge partial scanline from scratchpad over 
scratchpad 

SSMerge(3Q - scratchpad to scratchpad merge using ATOP 
operator 

SSMerge(3Q - scratchpad to scratchpad merge using IN opera¬ 
tor 

SSMerge(3Q - scratchpad to scratchpad merge using OUT 
operator 

SSMerge(3Q - scratchpad to scratchpad merge using OVER 
operator 

SSMerge(3Q - scratchpad to scratchpad merge using UNDER 
operator 

SSPaint(3Q - paint partial scanline from scratchpad over 
scratchpad 

SSPaint(3Q - merge pixels using spad matte 
SSPaint(3Q - SSPaint using OVER operator 
SSCopyComp(3C) - Copy one channel to another channel 
SSCopyComp(3C) - Copy one channel to another channel 
SSCopyComp(3C) - Copy one channel to another channel 
SSCopyComp(3C) - Copy one channel to another channel 
SSCopyRGBA(3C)~ Copy one channel from scratchpad to 4 channels 
SSCopyRGBA(3C)- Copy one channel from scratchpad to 4 channels 
through a color table 

SSShuffle(3C) - SSCopy, broadcasting single component of src to 
dst 

SSShuffle(3C) - SSCopy with specified channel rotation 
SSShuffle(3C) - SSCopy using specified roffset,goffset, boffset, 
aoffset transform 

SS Axb(3Q - Scale pixels using the formula A*x+B 

SYCopy(3C) - copy scratchpad buffer to Yapbus 

PW(3C) - set a pixel window channel mask 

YFCopy(3C) - copy Yapbus to framebuffer 

YSCopy(3C) - copy Yapbus to scratchpad 

TBCopy(3C) - copy between tile blocks in frame buffer memory 
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NAME 

CFxCopy 

CFyCopy 

CFxCopy B ackwards 
CFyCopyB ackwards 
CFxClear 
CFyClear 


- copy component from scratchpad to frame buffer in increasing x order 

- copy component from scratchpad to frame buffer in increasing y order 

- copy component from scratchpad to frame buffer in decreasing x order 

- copy component from scratchpad to frame buffer in decreasing y order 

- clear frame buffer in increasing x order to a component value 

- clear frame buffer in increasing y order to a component value 


SYNOPSIS 

CFxCopy(pw, src, n, x, y[, z]) 
int *pw; pixel *src; register n, x, y[, z]; 


CFyCopy(pw, src, n, x, y[, z]) 
int *pw; pixel *src; register n, x, y[, z]; 


CFxCopyBackwards(pw, src, n, x, y) 
int *pw; pixel *src; register n, x, y[, z]; 

CFyCopyBackwards(pw, src, n, x, y) 
int *pw; pixel *src; register n, x, y[, z]; 


CFxClear(pw, src, n, x, y[, z]) 
int *pw; pixel *src; register n, x, y[, z]; 

CFyClear(pw, src, n, x, y[, z]) 
int *pw; pixel *src; register n, x, y[, z]; 


DESCRIPTION 

CFxCopy and CFyCopy copy n pixel components from scratchpad into frame buffer memory. Individual 
components of the scratchpad array (starting with src and incrementing by 4) are broadcast across all four 
channels of the frame buffer pixels. The pixel window (pixel volume) pw must have previously been 
opened with OpenPW (OpenPV ); see PW( 3C). CFxCopy copies the n pixels from a scratchpad buffer 
starting at src into [x, y] to [x+n-1, y] of the pixel window. CFyCopy copies the n pixels from a scratchpad 
buffer starting at src into into [x, y] to [x, y+n-1] of the pixel window. If the pixel window is a pixel 
volume, a z coordinate is used to specify the slice. Clipping is performed with regard to the pw, and the 
number actually read is returned in acc. 

Only those channels indicated in the channel mask of the pixel window are written to the frame buffer; the 
other channels of frame buffer pixels are untouched. 

If the pixel window is actually a pixel volume, the z value is used to indicate the appropriate window of the 
volume. 


CFxCopyBackwards and CFyCopyB ackwards reverse the order of the pixels copied. 

CFxClear and CFyClear clear a scanline (horizontal and vertical, respectively) to the single channel com¬ 
ponent specified by the src pixel. 

LIBRARY 

libpta 

SEE ALSO 

PW(3C), TB(3C), IFCopy(3C), SFCopy(3C), FCCopy(3C) 

DIAGNOSTICS 

-1 is returned in acc if an invalid pixel window (pixel volume) is supplied. The number of pixels copied is 
returned in acc. 
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NAME 

CCCopy 
ICCopy 
CICopy 
IlCopy 

SYNOPSIS 

CCCopy(src, dst, n) 

ICCopy(src, dst, n) 

CICopy(src, dst, n) 

HCopy(src, dst, n) 
pixel *src, *dst; 
register n; 

DESCRIPTION 

These routines copy a single component of a pixel from scratchpad to scratchpad. The source and destin; 
tion are pixel pointers. A channel array pointer, (indicated by “C” in the title) is incremented by 4 for eac 
access. An integer array pointer (indicated by “I”) is incremented by 1 for each access. If the pix< 
pointer is a multiple of 4, the red component is copied; if the pixel pointer modulo 4 is 1, the green con 
ponent is copied, etc. 

A CICopy effectively copies one component of n adjacent pixels into consecutive components of memor 
Likewise, an ICCopy copies adjacent components into component positions offset by the destination. 

LIBRARY 

libpt.a 

SEE ALSO 

CRCopy(3C), SIClear(3C), SICopy(3C), CFCopy(3C) 

DIAGNOSTICS 

The number of pixels copied is returned in acc. 


- copy scratchpad channel array to scratchpad channel array 

- copy scratchpad integer array to scratchpad channel array 

- copy scratchpad channel array to scratchpad integer array 

- copy scratchpad integer array to scratchpad integer array 
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NAME 

CRCopy - copy scratchpad channel array to runlength array 

SYNOPSIS 

CRCopy(src, dst, n, threshold) 
pixel *src, *dst; register n, threshold; 

DESCRIPTION 

CRCopy copies n pixels from a scratchpad array src to a runlength array dst. A runlength array is a one- 
bit, single-channel, run-length-encoded array, with a count n followed by n run lengths. The initial run¬ 
length is the number of initial components <= threshold; the next is the number of subsequent components 
> threshold. When threshold is 0, this partitions arrays into zero and non-zero runs. 

LIBRARY 

libpt.a 

SEE ALSO 

PW(3C), TB(3C), RSCopy(3C). 
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NAME 

FxCCopy - copy scanline from arbitrary fb channel to spad channel array 

FyCCopy - copy vertical scanline from arbitrary fb channel to spad channel array 

FxCCopyBackwards - copy scanline from arbitrary fb channel backwards to spad channel array 

FyCCopyBackwards - copy vertical scanline backwards from arbitrary fb channel to spad channel a 

FRxCCopy - copy scanline from red fb channel to spad channel array 

FRyCCopy - copy vertical scanline from red fb channel to spad channel array 

FRxCCopyBackwards - copy scanline from red fb channel backwards to spad channel array 
FRyCCopyBackwards - copy vertical scanline backwards from red fb channel to spad channel array 
FGxCCopy - copy scanline from green fb channel to spad channel array 

FGyCCopy - copy vertical scanline from green fb channel to spad channel array 

FGxCCopy Backwards - copy scanline from green fb channel backwards to spad channel array 

FGyCCopy Backwards - copy vertical scanline backwards from green fb channel to spad channel arra} 

FBxCCopy - copy scanline from blue fb channel to spad channel array 

FByCCopy - copy vertical scanline from blue fb channel to spad channel array 

FBxCCopyBackwards - copy scanline from blue fb channel backwards to spad channel array 

FByCCopyBackwards - copy vertical scanline backwards from blue fb channel to spad channel array 

FAxCCopy - copy scanline from alpha fb channel to spad channel array 

FAyCCopy - copy vertical scanline from alpha fb channel to spad channel array 

FAxCCopyBackwards - copy scanline from alpha fb channel backwards to spad channel array 

FAyCCopyBackwards - copy vertical scanline backwards from alpha fb channel to spad channel arra> 
SYNOPSIS 

FxCCopy(pw, dst, n, x, y[, z], channelnumber) 

int *pw; int *dst; register n, x, y[, z]; index channelnumber; 

FyCCopy(pw, dst, n, x, y[, z], channelnumber) 

int *pw; int *dst; register n, x, y[, z]; index channelnumber; 

FxCCopyBackwards(pw, dst, n, x, y[, z], channelnumber) 
int *pw; int *dst; register n, x, y[, z]; index channelnumber; 

FyCCopyBackwards(pw, dst, n, x, y[, z], channelnumber) 
int *pw; int *dst; register n, x, y[, z]; index channelnumber; 

F[R|G|B|A]xCCopy(pw, dst, n, x, y[, z]) 
int *pw; int *dst; register n, x, y[, z]; 

F[R|G|B|A]yCCopy(pw, dst, n, x, y[, z]) 
int *pw; int *dst; register n, x, y[, z]; 

F[R|G|B|A]xCCopyBackwards(pw, dst, n, x, y[, z]) 
int *pw; int *dst; register n, x, y[, z]; 

F[R|G|B|A]yCCopyBackwards(pw, dst, n, x, y[, z]) 
int *pw; int ♦dst; register n, x, y[, z]; 

DESCRIPTION 

FxCCopy copies the n components from channel channelnumber (Red is 0; Green is 1; Blue is 2; Alpha 
3) of pixels [*,y] to [x+n-l,y] of pixel window pw into a scratchpad channel array starting at dst and inert 
menting by 4. A channel array is equivalent to a pixel array, except that only one channel is expected to b 
processed; consecutive channel components are 4 words apart. FyCCopy copies the n components ffoi 
channel channelnumber of pixels [x,y] to [x,y+n- 1] of that pixel window into a scratchpad channel arra 
starting at dst. The FxCCopyBackwards and FyCCopyBackwards routines reverse the order of the pixe 
copied. The FRxC, FRyC, FGxC ,..., FAyC routines copy a specific channel. 

The pixel window pw must have been previously opened with a call to OpenPW, PW( 3C). If the pixt 
window is a pixel volume, a z coordinate is used in every routine to specify the slice. Clipping is pei 
formed with regard to the pw , and the number of pixels actually read is returned in acc. 
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Only those channels indicated in the channel mask of the pixel window can be written to scratchpad. 

LIBRARY 

libpt-a 

SEE ALSO 

PW(3C), TB(3C), FSCopy(3C), FICopy(3C), CFCopy(3C) 

DIAGNOSTICS 

All routines return -1 in acc if an invalid pixel window is supplied. 
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NAME 

FxICopy - copy scanline from arbitrary fb channel to spad integer array 

FylCopy - copy vertical scanline from arbitrary fb channel to spad integer array 

FxICopy Backwards - copy scanline from arbitrary fb channel backwards to spad integer array 

FylCopyBackwards - copy vertical scanline backwards from arbitrary fb channel to spad integer array 

FRxICopy - copy scanline from red fb channel to spad integer array 

FRylCopy - copy vertical scanline from red fb channel to spad integer array 

FRxICopyBackwards - copy scanline from red fb channel backwards to spad integer array 

FRylCopyBackwards - copy vertical scanline backwards from red fb channel to spad integer array 

FGxICopy - copy scanline from green fb channel to spad integer array 

FGylCopy - copy vertical scanline from green fb channel to spad integer array 

FGxICopyBackwards - copy scanline from green fb channel backwards to spad integer array 

FGylCopyBackwards - copy vertical scanline backwards from green fb channel to spad integer array 
FBxICopy - copy scanline from blue fb channel to spad integer array 

FBylCopy - copy vertical scanline from blue fb channel to spad integer array 

FBxICopyBackwards - copy scanline from blue fb channel backwards to spad integer array 
FBylCopy Backwards - copy vertical scanline backwards from blue fb channel to spad integer array 

FAxICopy - copy scanline from alpha fb channel to spad integer array 

FAylCopy - copy vertical scanline from alpha fb channel to spad integer array 

FAxICopyBackwards — copy scanline from alpha fb channel backwards to spad integer array 

FAylCopyBackwards - copy vertical scanline backwards from alpha fb channel to spad integer array 

SYNOPSIS 

FxICopy(pw, dst, n, x, y[, z], channelnumber) 

int *pw; int *dst; register n, x, y[, z]; index channelnumber; 

FyICopy(pw, dst, n, x, y[, z], channelnumber) 

int *pw; int *dst; register n, x, y[, z]; index channelnumber; 

FxICopyBackwards(pw, dst, n, x, y[, zj, channelnumber) 
int *pw; int *dst; register n, x, y[, z]; index channelnumber; 

FyICopyBackwards(pw, dst, n, x, y[, z], channelnumber) 
int *pw; int *dst; register n, x, y[, z]; index channelnumber; 

F[R|G|B|A]xICopy(pw, dst, n, x, y[, z]) 
int *pw; int *dst; register n, x, y[, z]; 

F[R|G|B|A]yICopy(pw, dst, n, x, y[, z]) 
int *pw; int *dst; register n, x, y[, z]; 

F[R|G|B|A]xICopyBackwards(pw, dst, n, x, y[, z]) 
int *pw; int *dst; register n, x, y[, z]; 

F[RiGlBJA]yICopyBackwards(pw, dst, n, x, y[, z]) 
int *pw; int *dst; register n, x, y[, zj; 

DESCRIPTION 

FxICopy copies the n components from channel channelnumber of pixels [x,y] to [x+n-l,y] of pixel win¬ 
dow pw into a scratchpad integer array starting at dst and incrementing by 1. An integer array is like a 
component array, except that it takes one fourth the storage; consecutive integer components are consecu¬ 
tive words in scratchpad. FylCopy copies the n components from channel channelnumber of pixels [x,y] to 
[x.y+n-l] of that pixel window into a scratchpad integer array starting at dst. The FxICopyBackwards and 
FylCopyBackwards routines reverse the order of the pixels copied. The FRxI, FRyl, FGxI, ..., FAyl Rou¬ 
tines copy a specific channel. 

The pixel window pw must have been previously opened with a call to OpenPW, PW( 3C). If the pixel 
window is a pixel volume, a z coordinate is used in every routine to specify the slice. Clipping is per¬ 
formed with regard to the pw, and the number of pixels actually read is returned in acc. 
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Only those channels indicated in the channel mask of the pixel window can be written to scratchpad. 

LIBRARY 

libpt.a 

SEE ALSO 

PW(3C), TB(3C), FSCopy(3C), FICopy(3C), CFCopy(3C) 

DIAGNOSTICS 

All routines return -1 in acc if an invalid pixel window is supplied. 
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NAME 

FxRCopy - copy scanline from arbitrary fb channel to spad channel array 

FxGCopy - copy scanline from arbitrary fb channel to spad channel array 

FxBCopy - copy scanline from arbitrary fb channel to spad channel array 

FxACopy - copy scanline from arbitrary fb channel to spad channel array 

FyRCopy - copy vertical scanline from arbitrary fb channel to spad channel array 

FyGCopy - copy vertical scanline from arbitrary fb channel to spad channel array 

FyBCopy - copy vertical scanline from arbitrary fb channel to spad channel array 

FyACopy - copy vertical scanline from arbitrary fb channel to spad channel array 

SYNOPSIS 

FxRCopy(pw, dst, n, x, y[, z]) 
int *pw; int *dst; register n, x, y[, z]; 

FxGCopy(pw, dst, n, x, y[, z]) 
int *pw; int *dst; register n, x, y[, z]; 

FxBCopy(pw, dst, n, x, y[, z]) 
int *pw; int ""dst; register n, x, y[, z]; 

FxACopy(pw, dst, n, x, y[, z]) 
int *pw; int *dst; register n, x, y[, z]; 

FyRCopy(pw, dst, n, x, y[, z]) 
int *pw; int *dst; register n, x, y[, z]; 

FyGCopy(pw, dst, n, x, y[, z]) 
int *pw; int *dst; register n, x, y[, z]; 

FyBCopy(pw, dst, n, x, y[, z]) 
int *pw; int *dst; register n, x, y[, z]; 

FyACopy(pw, dst, n, x, y[, z]) 
int *pw; int *dst; register n, x, y[, z]; 

DESCRIPTION 

These procedures copy a pixel from the framebuffer into 4 consecutive component values in scratchpad. 

FxRCopy, FxGCopy, FxBCopy, and FxACopy copy the n pixels [x,y] to [x+n-lj] of that pixel window into 
a scratchpad channel array starting at dst. Each pixel is copied to 4 consecutive pixels in the scratchpad 
array. Each procedure copies to a different component. 

FyRCopy, FyGCopy, FyBCopy, and FyACopy copy the n pixels [x,y] to [x,y+n- 1] of that pixel window into 
a scratchpad channel array starting at dst. Each pixel is copied to 4 consecutive pixels in the scratchpad 
array. Each procedure copies to a different component. 

The pixel window pw must have been previously opened with a call to OpenPW, PW (3C). If the pixel 
window is a pixel volume, a z coordinate is used in every routine to specify the slice. Clipping is per¬ 
formed with regard to the pw, and the number of pixels actually read is returned in acc. 

Only those channels indicated in the channel mask of the pixel window can be written to scratchpad. 

LIBRARY 

libpta 

SEE ALSO 

PW(3C), TB(3Q, FSCopy(3C), FICopy(3C), CFCopy(3C) 

DIAGNOSTICS 

All routines return -1 in acc if an invalid pixel window is supplied. 
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Only those channels indicated in the channel mask of the pixel window can be written to scratchpad. 

LIBRARY 

libpt.a 

SEE ALSO 

PW(3C), TB(3C), FSCopy(3C), FCCopy(3C), IFCopy(3C) 

DIAGNOSTICS 

All routines return -1 in acc if an invalid pixel window is supplied. The number of pixels copied is 
returned in acc. 
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NAME 

FxSCopy - copy partial scanline from frame buffer to scratchpad 

FySCopy - copy partial vertical scanline from frame buffer to scratchpad 

FxSCopyBackwards - copy partial scanline from frame buffer backwards to scratchpad 
FySCopyBackwards - copy partial vertical scanline backwards from frame buffer to scratchpad 

SYNOPSIS 

FxSCopy(pw, dst, n, x, y[, z]) 
int *pw; pixel *dst; register n, x, y[, z]; 

FySCopy(pw, dst, n, x, y[, z]) 
int *pw; pixel *dst; register n, x, y[, z]; 

FxSCopyBackwards(pw, dst, n, x, y[, z]) 
int *pw; pixel *dst; register n, x, y[, z]; 

FySCopyBackwards(pw, dst, n, x, y[, zl) 
int *pw; pixel *dst; register n, x, y[, z]; 

DESCRIPTION 

These routines copy n pixels from frame buffer to scratchpad. The pixel window pw must have been previ¬ 
ously opened with a call to OpenPW, PW(3 C). FxSCopy copies the n pixels from [x,y] to [x+n-l,y] of that 
pixel window into a scratchpad buffer starting at dst. FySCopy copies the n pixels from [x,y] to [x,y+n of 
that pixel window into a scratchpad buffer starting at dst. Clipping is performed with regard to the pw, and 
the number of pixels actually read is returned in acc. 

The FxSCopyBackwards and FySCopyBackwards routines reverse the order of the pixels copied. 

If the pixel window is actually a pixel volume, the z value is used to indicate the appropriate window of the 
volume. 

Only those channels indicated in the channel mask of the pixel window are written to scratchpad. The 
other channels of scratchpad pixels are left untouched. 

LIBRARY 

libpt.a 

SEE ALSO 

PW(3C),TB(3C) 

DIAGNOSTICS 

All routines return -1 in acc if an invalid pixel window is supplied. 
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NAME 

FYCopy 

SYNOPSIS 

FYCopy(tile, chanmask, dest addr) 
int *tile; register chanmask, dest_addr 

DESCRIPTION 

This routine copies pixels from the framebuffer to the yapbus. Transfers are tile-based, tile (bO) holds the 
number of the tile to be sent out. chanmask (rO) holds the channel mask to be used when reading data from 
the framebuffer. dest_addr (rl) has the receiver address that data is to be sent to, and must be a number 
from 1 through 15. 

Pixels are transmitted at a rate of two pixels per CPU tick. The transmitter priority is set to be the same as 
the dest_addr. Garbage is sent on the yapbus channels masked off in the channel mask. The same or a 
more restrictive mask must be used at the receiver. 

LIBRARY 

libpta 

SEE ALSO 

YFCopy.3c 

DIAGNOSTICS 

A non-zero value is returned in acc if a transmission problem occurs. 
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NAME 

IFxCopy - copy partial scanline from scratchpad integer array to frame buffer 
IFyCopy - copy partial vertical scanline from scratchpad integer array to frame buffer 
IFxCopyBackwards - copy partial scanline backwards from scratchpad integer array to frame buffer 
IFyCopyBackwards - copy partial vertical scanline backwards from scratchpad integer array to frame buffer 
IFxClear - clear partial scanline using scratchpad integer value 
IFyClear - clear partial vertical scanline using scratchpad integer value 

SYNOPSIS 

IFxCopy(pw, n, n, x, y[, z]) 
int *pw; int *n; register n, x, y[, z]; 

IFyCopy(pw, n, n, x, y[, z]) 
int *pw; int *n; register n, x, y[, zj; 

IFxCopyBackwardsfpw, n, n, x, y) 
int *pw; int *n; register n, x, y[, z]; 

IFyCopy Back war ds(pw, n, n, x, y) 
int *pw; int *n; register n, x, y[, z]; 

IFxCIear(pw, n, n, x, y[, z]) 
int *pw; int *n; register n, x, y[, z]; 

IFyClear(pw, n, n, x, y[, z]) 
int *pw; int *n; register n, x, y[, z]; 

DESCRIPTION 

IFxCopy and IFyCopy copy n pixel components from scratchpad into frame buffer. Individual components 
of the scratchpad array (starting with n and incrementing by 1) are broadcast across all four channels of the 
frame buffer pixels. The pixel window (pixel volume) pw must have previously been opened with 
OpenPW ( OpenPV)\ see PW( 3C). IFxCopy copies the n components from a scratchpad buffer starting at n 
into [x,y] to [x+/t-l,y] of the pixel window. IFyCopy copies the n components from a scratchpad buffer 
starting at n into [x, y] to [x, y+/i-l] of the pixel window. Clipping is performed with regard to the pw, and 
the number actually read is returned in acc. 

IFxCopyBackwards and IFyCopyBackwards reverse the order of the components copied. 

If the pixel window is actually a pixel volume, the z value is used to indicate the appropriate window of the 
volume. 

IFxClear and IFyClear clear the destination framebuffer scanline (horizontal and vertical, respectively) to 
the value specified by the single scratchpad integer specified by the source. 

Only those channels indicated in the channel mask of the pixel window are written to the frame buffer; the 
other channels of frame buffer pixels are untouched. 

LIBRARY 

libpta 

SEE ALSO 

PW(3C), TB(3C), FICopy(3C), SFCopy(3C), CFCopy(3C) 

DIAGNOSTICS 

-1 is returned in acc if an invalid pixel window (pixel volume) is supplied. 
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NAME 


OpenPW 

- create a pixel window for frame buffer access 

OpenPV 

- create a pixel volume for frame buffer access 

ReOpenPW 

- create a pixel window for frame buffer access 

InqPW 

- provide information about an open pixel window 

InqPV 

- provide information about an open pixel volume 

ClosePW 

- close a pixel window 

ClosePV 

- close a pixel volume 

InitPW 

- initialize the pixel window area 

InitPV 

- initialize the pixel volume area 

SetMaskPW 

- set a pixel window channel mask 


SYNOPSIS 

int *OpenPW(tb, minx, maxx, miny, maxy) 
int *tb; register minx, maxx, miny, maxy; 

int *OpenPV(tb, nx, ny, nz) 

int *ReOpenPW(tb, pw, minx, maxx, miny, maxy) 

int *tb; int *pw; register minx, maxx, miny, maxy; int *tb; register nx, ny, nz; 

InqPW(pw) 
int *pw; 

InqPV(pv) 
int *pv; 

ClosePW(pw) 
int *pw; 

ClosePV(pv) 
int *pv; 

InitPWO 

InitPVO 

SetMaskPW(pw, channelmask) 
int *pw; register channelmask; 

DESCRIPTION 

A pixel window is a logical window into an allocated chunk of frame buffer memory. All frame buffer 
accesses are offset to an open pixel window and clipped to its bounds. OpenPW creates a pixel window 
inside an allotted tile block tb. The bounds are set by the standard window four-tuple. The channel mask 
is set to indicate all four channels. A pixel window pointer is returned. 

All frame buffer accesses are offset to an open pixel volume and clipped to its bounds. OpenPV creates a 
pixel volume inside an allotted tile block tb. Each of nz windows of the pixel volume is of size ( nx,ny ). A 
pixel volume pointer, which may be used interchangeably with a pixel window pointer, is returned. When 
a pixel volume pointer is used in place of a pixel window pointer, a z value must be supplied to indicate the 
desired slice. 

ReOpenPW reuses the same pixel window with different bounds. 

InqPW does the inverse of OpenPW , taking a pw and returning its tb and the window bounds. 

InqPV does the inverse of OpenPV , taking a pv and returning its tb and the volume sizes. 

ClosePW ( ClosePV) closes an open pixel window (pixel volume). 

InitPW clears out all pixel window structures to offer a fresh start; the routine InitPV is also offered. 

SetMaskPW associates a channel mask with a pixel window. All further accesses to that window affect 
only the selected channel(s). The argument channelmask is of the same form as the runflag of the Chap, 
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with RGB A indicated by bits 0,1,2, 3 respectively. 

LIBRARY 

libpta 

SEE ALSO 

TB(3C) 

DIAGNOSTICS 

OpenPW and ReOpenPW return -1 in acc on failure, 0 on success. Reasons for failure are: maxx < minx, 
maxy < miny; tb not valid; minx < 0; miny < 0; maxx or maxy too big for this tile block; no more space for 
window structures. 

InqPW and ClosePW return -1 in acc on failure (invalid pw), 0 on success. 
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NAME 

PW4Map - remap 4 components of a pixel window 

SYNOPSIS 

PW4Map(pwsrc, dstpw, map, spada, spadb) 

PW *pwsrc, *dstpw; 

pixel *map; 

pixel *spada, *spadb; 

DESCRIPTION 

PW4Map changes the color values of a pixel window according to a function expressed as a map between 
pixel values in and pixel values out 

The map table is actually four tables: TR, TG, TB, TA. The map table should point to the untesselated 4- 
way value TR[0], TG[0], TB[0], TA[0]. The 4 components of each pixel in the srcpw are used as 4 indices 
into these 4 tables, are looked up, and then written to the pwdst. Note that if the sre array contains negative 
values (and pixel values may be negative), the table should extend not only forward in scratchpad memory 
from the map table, but also backwards. 

LIBRARY 

libpta 

SEE ALSO 

PirlMapComp(3H), PirlMakeMap(3H), PirlCha(3H) 

SS4Map(3C), PWMap(3C) 
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NAME 

PWAxb - compute new pixel = a*pixel+& for a pixel window. 

SYNOPSIS 

PWAxb (pw, a, b, spad) 
int *pw; 
pixel *a,*b; 
pixel *spad; 

DESCRIPTION 

PWAxb computes a new pixel value by multiplying each pixel component by the appropriate components 
of a and adding b. The factors are four-way 11-bit values, where 1.0E (2048). This function is useful for 
performing simple channel arithmetic. 

The spad buffer is equal to the maximum of the x and y directions (in pixels) of the pixel window in pixels. 

LIBRARY 

libpt.a 

SEE ALSO 

PirlAxb(3H), PirlArithmetic(3H), SSAxb(3C) 
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NAME 

PWCha - perform channel arithmetic on the pixels of a pixel window 

SYNOPSIS 

PWCha (pw, inbfr, outbfr, coeffs) 
int *pw; 

pixel *inbfr, *outbfr; 
register coeffs; 

DESCRIPTION 

PWCha applies a linear transformation to the channel values of each pixel within a specified pixel window, 
given in bO on entry. The transformation is given by a 4x5 array of coefficients in scratchpad memory. A 
pointer to this array is assumed to be in ALU register rO when PWCha is called. The function also requires 
an input and output buffer to be available in scratchpad; pointers to these must be provided in bl and b2, 
respectively. 

The values in the coefficient matrix are 11-bit pixel values. Multiplication is performed as though the 
channel values were a homogeneous 5-vector being pre-multiplied by the coefficient matrix: the first five 
values in the array determine the output red value by summing the products of the four channel values with 
the first four matrix values, and adding the fifth matrix value to the sum. 

LIBRARY 

libpt.a 

SEE ALSO 

SSCha(3C), PirlCha(3H) 

ERRORS 

The ALU accumulator acc has 0 for normal return, -1 for errors. 


Release 1.2 


July 1,1986 


1 



PWCLAMP (3C) 


Pixar Programmer’s Manual 


PWCLAMP (3C) 


NAME 

PWClamp - clamp pixel between 0.0 (0) and 1.0 (0x800) for a pixel window 

SYNOPSIS 

PWClamp (pw, spad) 
int *pw; 
pixel *spad; 

DESCRIPTION 

PWClamp clamps each pixel in a pixel window to a minimum of 0.0 (0) and a maximum of 1.0E (2048). 
This is useful for removing the values outside this range that are occasionally produced by filtering. 

The spad buffer is equal to the maximum of the x and y directions (in pixels) of the pixel window in pixels. 

LIBRARY 

libpt.a 

SEE ALSO 

SSClamp(3C) 


Release 1.2 


July 1,1986 


1 



PWCLEAR (3C) 


Pixar Programmer’s Manual 


PWCLEAR (3C) 


NAME 

PWClear - clear pixel window to color 

SYNOPSIS 

PWClear (pw,color,spad) 
int *pw; 
pixel *color; 
pixel *spad; 

DESCRIPTION 

PWClear clears the pixel window to color. 

The spad buffer is equal to the maximum of the x and y directions (in pixels) of the pixel window in pixels. 
LIBRARY 

libpt.a 

SEE ALSO 

PirlClear(3H) 
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NAME 

PWCopy - copy the source pixel window to the destination pixel window 

PWCopyGeneric - PWCopy with user-specified axes, start and direction parameters 

SYNOPSIS 

PWCopy (srcpw, dstpw, spad) 
int *srcpw; 
int * dstpw; 
pixel *spad; 

PWCopy (srcpw, dstpw, spad, 

srcRtn, srcStart, srclnc, srcAxis, dstRtn, dstStart, dstlnc, dstAxis) 
int *srcpw; 
int *dstpw; 
pixel *spad; 

register srcRtn,srcStart,srcInc,srcAxis,dstRtn,dstStart,dstlnc,dstAxis; 

DESCRIPTION 

PWCopy copies the source pixel window to the destination pixel window. The pixel windows may over¬ 
lap, although the source pixel window will be overwritten. The spad buffer is equal to the maximum of the 
x-size of the source pixel window. 

PWCopyGeneric copies the source pixel window to the destination pixel window. This routine allows the 
user to specify several options for greater control of the copying operation. The srcRtn is used to extract a 
scanline from the framebuffer into spad. The srcStart and srclnc parameters specify the starting line, rela¬ 
tive to the start of the source pixel window, and the increment (usually 1 or -1) in the direction of srcAxis 
(0 for x direction, 1 for y direction). Similarly, the dstRtn is used to copy the spad buffer into the frame- 
buffer. dstStart, dstlnc, dstAxis have the same semantics as their source counterparts. 

The spad buffer must be large enough to hold the maximum number of pixels copied from the framebuffer 
by srcRtn. 

For programming examples, see the source for PirlCopy and PirlReflect. 

LIBRARY 

libpLa 

SEE ALSO 

PirlCopy(3H), FSCopy(3C), SFCopy(3C), PWSwap(3C) 

ERRORS 

Both pixel windows must be the same size and belong to the same Chap. 

Both axis specifiers in PWCopyGeneric must be the same (either 0 or 1). 


Release 1.2 


July 1,1986 


1 



PWGENERIC (3C) 


Pixar Programmer’s Manual 


PWGENERIC (3C) 


NAME 

PWGeneric - call a spad-to-spad routine for each line of a pixel window 

SYNOPSIS 

PWGeneric (pw, routine, spad) 
int *pw; 
register routine; 
pixel *spad; 

DESCRIPTION 

PWGeneric applies the function routine to each line of pixel window. This routine must not use any other 
registers. This is useful for simple routines, like clamp, which need no external information other than the 
data in the pixel window. 

routine is the address of the routine in the chap. 

The spad buffer is equal to the maximum of the x and y directions (in pixels) of the pixel window. 

LIBRARY 

libpt.a 

SEE ALSO 

PWNot(3C), PWClamp(3C) 
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NAME 

PWMerge - merge two pixel windows into a third 

SYNOPSIS 

PWMerge (fgddw, bkgdw, dstdw, fgdspad bkgspad dstspad merger, Lf, Lb, jOkO) 

int *fgddw, *bkgdw, *dstdw; 

int *fgdspad, *bkgspad, *dstspad; 

int merger; 

register Lf, Lb, jOkO; 

DESCRIPTION 

The paper “Compositing Digital Images,” SIGGRAPH ‘84, discusses the semantics of merging. Briefly, 
compositing is performed by combining images using the fourth (alpha) channel in the image as a matte 
giving the opacity of image at each pixel. The assumption is that the interesting information in an image is 
confined to pixels with non-zero opacity, so that the matte may be used to allow backgrounds to show 
through, in proportion to the value of alpha. 

PWMerge implements the Porter-Duff compositing algegra on a pair of pixel windows, given by fgddw and 
bkgdw , writing the composited pixels into dstdw (the dimensions of the three pixel windows must be identi¬ 
cal, but the pixel windows themselves need not be distinct). The routine requires the addresses of three 
buffers, corresponding to the three pixel windows and equal in size to a scan line. Pointers to these buffers 
must be in fgdspad, bkgspad, and dstspad. 

The merge operation is performed by the Chap routine whose address is in merger. The routine 
SSMerge( 3C) performs all of the merge operations described in the Porter-Duff paper, as determined by the 
parameter jOkO, a 4-way register value in r2. However, there exist scratchpad-to-scratchpad routines which 
are optimized for certain of these operations. They may be found in other man pages (see the SEE ALSO 
section below). 

The Lf and Lb parameters give attenuation factors for the channels of the foreground and background 
images, respectively. Their semantics are also discussed in the paper, as well as in the man page for 
PirlMerge{ 3H). 

LIBRARY 

libpta 

SEE ALSO 

“Compositing Digital Images,” by Porter and Duff ( SIGGRAPH '84) 

PirlMerge(3H), SSMerge(3C) 

BUGS 

As discussed in the paper, this style of compositing is susceptible to failure on correlated data, for example 
when the two input pixel windows depict objects with adjacent edges. 
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NAME 

PWNot - subtract pixel value from 1.0 (0x800) for a pixel window 

SYNOPSIS 

PWNot (pw,spad) 
int *pw; 
pixel *spad; 

DESCRIPTION 

PWNot subtracts the pixel value from 1.0E (2048) for each pixel in the pixel window. 

The spad buffer is equal to the maximum of the x and y directions (in pixels) of the pixel window. 
LIBRARY 

libpta 

SEE ALSO 

PirlNot(3H) 
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NAME 

PWShift - shift pixel window contents in x and/or y 

PWCircularShift - circular shift pixel window contents in x and/or y 

SYNOPSIS 

PWShift (pw, x, y, spad) 
int *pw; 
register x,y; 
pixel *spad; 

PWCircularShift (pw, x, y, spad) 
int *pw; 
register x, y; 
pixel *spad; 

DESCRIPTION 

PWShift shifts the contents of a pixel window in x and/or y. The pixels shifted outside the pixel window 
are clipped. The original pixels are retained in the exposed area. X and Y may be positive or negative. 

PWCircularShift shifts the contents of a pixel window in x and/or y. The pixels shifted outside the pixel 
window are circularly shifted around the edge of the pixel window into the exposed area. 

The spad buffer is equal to the maximum of the x and y directions (in pixels) of the pixel window. 
LIBRARY 

libpt.a 

SEE ALSO 

PirlShift(3H) 
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NAME 

PWShuffle — shuffle components of each pixel for a pixel window. 

SYNOPSIS 

PWShuffle (pw, r, g, b, a, spad) 
int *pw; 
index r, g, b, a; 
pixel *spad; 

DESCRIPTION 

PWShuffle uses the index values in r, g, b, a to form a general purpose crossbar for shuffling of pixel com¬ 
ponents. 

The index from zero to three in each of the r, g, b, a index registers is the offset from which to draw the 
source component. 

The spad buffer is equal to the maximum of the x and y directions (in pixels) of the pixel window. 
LIBRARY 

libpt.a 

SEE ALSO 

PirlShuffle(3H), SSShuffle(3C) 
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NAME 

PWSwap - swap the source pixel window and the destination pixel window. 

SYNOPSIS 

PWSwap (srcpw, dstpw, spadO, spadl) 

pixel *srcpw; 

pixel *dstpw; 

pixel *spadO,*spadl; 

DESCRIPTION 

PWSwap swaps the source pixel window and the destination pixel window. 

The spad buffers, spadO and spadl , are equal to the x-size of the pixel window. 

LIBRARY 

libpt.a 

SEE ALSO 

PirlSwap(3H), FSCopy(3C), SFCopy(3C) 

ERRORS 

Both pixel windows must be the same size, not overlap, and belong to the same Chap. 
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NAME 

PWTranspose - transpose a pixel window around the diagonal axis. 

SYNOPSIS 

PWTranspose (pw, spad) 
pixel *pw; 
pixel *spad; 

DESCRIPTION 

PWTranspose transposes a pixel window around its diagonal axis (0,0) to (N,N). Any orientation of the 
pixel window may be achieved by a combination of transpositions and reflections. 

The spad buffer is equal to the maximum of the x and y directions (in pixels) of the pixel window. 
LIBRARY 

libpta 

SEE ALSO 

PirlTranspose(3H), PWGeneralS wap(3C) 

ERRORS 

The pixel window must be square. 
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NAME 

RFxCopy, 

GFxCopy, 

BFxCopy, 

AFxCopy - copy component from scratchpad to frame buffer in increasing x order 

RFyCopy, 

GFyCopy, 

BFyCopy, 

AFyCopy - copy component from scratchpad to frame buffer in increasing y order 

SYNOPSIS 

RFxCopy(pw, src, n, x, y[, z]) 
int *pw; pixel *src; register n, x, y[, z]; 

GFxCopy(pw, src, n, x, y[, z]) 
int *pw; pixel *src; register n, x, y[, z]; 

BFxCopy(pw, src, n, x, y[, z]) 
int *pw; pixel *src; register n, x, y[, z]; 

AFxCopy(pw, src, n, x, y[, z]) 
int *pw; pixel *src; register n, x, y[, z]; 

RFyCopy(pw, src, n, x, y[, z]) 
int *pw; pixel *src; register n, x, y[, z]; 

GFyCopy(pw, src, n, x, y[, z]) 
int *pw; pixel *src; register n, x, y[, z]; 

BFyCopy(pw, src, n, x, y[, z]) 
int *pw; pixel *src; register n, x, y[, z]; 

AFyCopy(pw, src, n, x, y[, z]) 
int *pw; pixel *src; register n, x, y[, z]; 

DESCRIPTION 

These procedures copy 4 consecutive component values, either the R, G, B or A, into a pixel in the frame- 
buffer. 

The pixel window (pixel volume) pw must have previously been opened with OpenPW (OpenPV ); see 
PW(3C). RFxCopy, GFxCopy, BFxCopy, and AFxCopy copy 4*n component values from a scratchpad 
buffer starting at src into [x,y] to [x+n-l.y] of the pixel window. RFyCopy, GFyCopy, BFyCopy, and 
AFyCopy copy 4*n pixels from a scratchpad buffer starting at src into into [x, y] to [x, y+n- 1] of the pixel 
window. If the pixel window is a pixel volume, a z coordinate is used to specify the slice. Clipping is per¬ 
formed with regard to the pw, and the number actually read is returned in acc. Note that n is the number of 
pixels written into the frame buffer which is 1/4 the size of the scratchpad array. 

Only those channels indicated in the channel mask of the pixel window are written to the frame buffer; the 
other channels of frame buffer pixels are untouched. 

If the pixel window is actually a pixel volume, the z value is used 

LIBRARY 

libpLa 

SEE ALSO 

PW(3C), TB(3C), FRGBACopy(3C), IFCopy(3C), SFCopy(3C), FCCopy(3C) 

DIAGNOSTICS 

-1 is returned in acc if an invalid pixel window (pixel volume) is supplied. The number of pixels copied is 
returned in acc. 
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NAME 

RSCopy, 

SRCopy - copy runlength array to scratchpad pixel array 

SYNOPSIS 

RSCopy(src, dst) 
int *src; pixel *dst; 

DESCRIPTION 

RSCopy expands a runlength array src to a normal scratchpad pixel array dst. A runlength array is a one- 
bit, single-channel, run-length-encoded array, with a count n followed by n run lengths. The initial run¬ 
length is the number of initial zeros; the next is the number of subsequent nonzeros, etc. This routine 
expands such a 1-bit description into an array of (0,0,0,0) and (2048,2048,2048,2048) pixels. 

LIBRARY 

libpt.a 

SEE ALSO 

PW(3C), TB(3C) 
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NAME 

SCCopy, 

SCClear - copy partial scanline from scratchpad to scratchpad 

SYNOPSIS 

SCCopy(source, target, n, channelnumber) 

pixel ^source; component *target; register n, channelnumber; 

SCClear(source, target, n, channelnumber) 
pixel ^source; component *target; register n; 

DESCRIPTION 

SCCopy copies n pixels from a scratchpad pixel array source to a scratchpad channel array target. 

SCClear copies a channel of a pixel n times to a target channel array without incrementing the source pixel 
pointer. The target channel array is effectively cleared to the value of the channel channelnumber of the 
source pixel. 

LIBRARY 

libpta 

SEE ALSO 

PW(3C), TB(3C) 

DIAGNOSTICS 

The number of channels copied is returned in acc. 
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NAME 

SFxCopy 

SFyCopy 

SFxCopyBackwards 
SFyCopyBackwards 
SFxCopyRGBA, 
SFxCopy ARGB, 
SFxCopy BARG, 
SFxCopy GBAR 
SFyCopyRGBA, 
SFyCopy ARGB, 
SFyCopyBARG, 
SFyCopyGBAR 
SFxClear 
SFyClear 


- copy partial scanline from scratchpad to frame buffer 

- copy partial vertical scanline from scratchpad to frame buffer 

- copy partial scanline backwards from scratchpad to frame buffer 

- copy partial vertical scanline backwards from scratchpad to frame buffer 


- SFxCopy w/ channel rotation 


- SFyCopy w/ channel rotation 

- clear partial scanline in frame buffer 

- clear partial vertical scanline in frame buffer 


SYNOPSIS 

SFxCopy(pw, src, n, x, y[, z]) 
int *pw; pixel *src; register n, x, y[, z]; 

SFyCopy(pw, src, n, x, y[, z]) 
int *pw; pixel *src; register n, x, y[, z]; 

SFxCopyBackwards(pw, src, n, x, y) 
int *pw; pixel *src; register n, x, y[, z]; 

SFyCopyBackwards(pw, src, n, x, y) 
int *pw; pixel *src; register n, x, y[, z]; 

SFxCopyRGBA(pw, src, n, x, y[, z]) 
SFxCopyARGB(pw, src, n, x, y[, z]) 
SFxCopyBARG(pw, src, n, x, y[, z]) 
SFxCopyGBAR(pw, src, n, x, y[, z]) 
int *pw; pixel *src; register n, x, y[, z]; 

SFyCopyRGBA(pw, src, n, x, y[, z]) 
SFy Copy ARGB (pw, src, n, x, y[, z]) 
SFyCopyBARG(pw, src, n, x, y[, zj) 
SFyCopyGBAR(pw, src, n, x, y[, z]) 
int *pw; pixel *src; register n, x, y[, z]; 

SFxClear(pw, src, n, x, y[, z]) 
int *pw; pixel *src; register n, x, y[, z]; 

SFyCIear(pw, src, n, x, y[, zj) 
int *pw; pixel *src; register n, x, y[, z]; 


DESCRIPTION 

All of these routines copy pixels from the scratchpad to the framebuffer. Various combinations and direc¬ 
tions are supported. 

Only those channels indicated in the channel mask of the pixel window are written to the frame buffer; the 
other channels of frame buffer pixels are untouched. 

SFxCopy and SFyCopy copy n pixels from scratchpad into frame buffer. The pixel window (pixel volume) 
pw must previously been opened with OpenPW (OpenPV ); see PW( 3C). SFxCopy copies the n pixels from 
a scratchpad buffer starting at src into [x, y] to [x+n-\,y] of the pixel window. SFyCopy copies the n pixels 
from a scratchpad buffer starting at src into into [x, y] to [x, y+n-l] of the pixel window. If the pixel win¬ 
dow is a pixel volume, a z coordinate is used to specify the slice. Clipping is performed with regard to the 
pw, and die number actually read is returned in acc. 


Release 1.2 


July 1,1986 


1 



SFCOPY (3C) 


Pixar Programmer’s Manual 


SFCOPY (3C) 


SFxCopyBackwards and SFyCopyBackwards reverse the order of the pixels copied. 

If the pixel window is actually a pixel volume, the z value is used to indicate the appropriate window of the 
volume. 

SFxCopyRGBA, SFxCopyARGB, SFxCopyBARG, and SFxCopyGBAR perform an SFxCopy, but rotate the 
channel components during the copy. SFxCopyRGBA, SFxCopyARGB, SFxCopyBARG, SFxCopyGBAR 
rotate the channel components zero, one, two and three positions, respectively. ( SFxCopyRGBA is exactly 
the same as SFxCopy) 

SFyCopyRGBA, SFyCopyARGB, SFyCopyBARG and SFyCopyGBAR perform the same operations on vert¬ 
ical scanlines. 

SFxClear and SFyClear do not increment through a src scratchpad array; the frame buffer scanline is 
cleared to the value of the pixel pointed to by src . 

LIBRARY 

libpt.a 

SEE ALSO 

PW(3C), TB(3C), SSCopy(3C), SSShuffle(3C) 

DIAGNOSTICS 

-1 is returned in acc if an invalid pixel window (pixel volume) is supplied. The number of pixels copied is 
returned in acc. 
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NAME 

SICopy - copy channels from a pixel array to integer array 

SIClear - clear an integer array to a single channel value 

SYNOPSIS 

SICopy(src, dst, count, channelnumber) 
pixel *src,*dst; register count, channelnumber; 

SIClear(src, dst, count, channelnumber) 
pixel *src,*dst; register count, channelnumber; 

DESCRIPTION 

SICopy copies count channels from the pixel array pointed to by src to the the integer array pointed to by 
dst, using the specified channel number. 

SIClear clears the integer array pointed to by dst of length count, to the single channel value pointed to by 
src, using the specified channel number. 

LIBRARY 

libpt.a 

SEE ALSO 

CRCopy(3C) 
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NAME 

SS4Map - 4-way mapping of scratchpad values using a mapping table 

SYNOPSIS 

SS4Map(src,dst, maptable,n) 
pixel *src, *dst, *maptable; register n; 

DESCRIPTION 

The map table is actually four tables: TR, TG, TB, TA. The map table should point to the untesselated 4- 
way value TR[0], TG[0], TB[0], TA[0]. The src array is used as 4-way indices into the 4-way table to pro¬ 
duce the 4-way dst array. Note that if the src array contains negative values (and pixel values may be 
negative), the table should extend not only forward in scratchpad memory from the map table, but also 
backwards. 

LIBRARY 

libpta 
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NAME 

SSaxb - scale pixels using the formula A*x+B 

SYNOPSIS 

SSaxb(src, dst, n, A, B) 
pixel *src, *dst; register n, A, B; 

DESCRIPTION 

SSaxb copies n pixels from a scratchpad src to a scratchpad dst. Input pixels are multiplied by a four-way 
11-bit factor, A, and added to a four-way 11-bit term, B . 

TIMING 

The inner loop takes 2 ticks. 

LIBRARY 

libpta 

SEE ALSO 

PW(3C), TB(3C), SSCopy(3C) 
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NAME 

SSCha - perform channel arithmetic on the pixels of a pixel window 

SYNOPSIS 

SSCha(inbfr, outbfr, coeffs, linesize) 
pixel *inbfr, *outbfr, *coeffs; 
register linesize; 

DESCRIPTION 

SSCha applies a linear transformation to the channel values of each pixel in the input pixel buffer in 
scratchpad (pointed to by bO upon entry), placing the result in the output buffer pointed to by bl. The 
transformation is applied to the number of pixels in rO, and is specified by a 4x5 array of coefficients in 
scratchpad memory. A pointer to this array is assumed to be in ALU register b2. 

The values in the coefficient matrix are 11-bit pixel values. Multiplication is performed as though the 
channel values were a homogeneous 5-vector being pre-multiplied by the coefficient matrix: the first five 
values in the array determine the output red value by summing the products of the four channel values with 
the first four matrix values, and adding the fifth matrix value to the sum. 

LIBRARY 

libpt.a 

SEE ALSO 

PWCha(3C), PirlCha(3H) 

ERRORS 

The ALU accumulator acc has 0 for normal return, -1 for errors. 
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NAME 

SSComb - Combine two images 

SYNOPSIS 

SSComb( srca, srcb, dst, n, A, B) 
pixel *srca, *srcb, *dst; register n, A, B; 

DESCRIPTION 

SSComb forms a linear combination of n pixels from scratchpad srca and srcb and writes the result to dst. 
Input pixels from srca are multiplied by a four-way 14-bit factor, A, and added to to the input pixels from 
srcb multiplied by a four-way 14-bit factor, B. 

TIMING 

The inner loop takes 6 ticks. 

LIBRARY 

libpta 

SEE ALSO 

PW(3C), TB(3C), SSAxb(3C), SSMerge(3C), SSCopy(3C) 
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NAME 

SSCompare - compare scanline pixel buffers in scratchpad 

SYNOPSIS 

SSCompare(srcO, srcl, n) 
pixel *srcO, ♦srcl; register n; 

DESCRIPTION 

SSCompare compares n pixels in scratchpad buffers src 0 and src 1. 

Each time a comparison fails, acc is incremented. This results in the four accumulators holding the number 
of failed comparisons for the four channels. 

LIBRARY 

libpt.a 
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NAME 

SSCopy, 

SSClear - copy partial scanline from scratchpad to scratchpad 

SYNOPSIS 

SSCopy(src, dst, n) 
pixel *src, *dst; register n; 

SSClear(src, dst, n) 
pixel *src, *dst; register n; 

DESCRIPTION 

SSCopy copies n pixels from a scratchpad src to a scratchpad dst. 

SSClear copies n pixels to a dst scratchpad location, without incrementing the src pixel pointer. The dst 
pixel array is effectively cleared to the value of the src pixel. 

LIBRARY 

libpta 

SEE ALSO 

PW(3C), TB(3C) 

DIAGNOSTICS 

The number of pixels copied is returned in acc. 
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NAME 

SSRRRRtoRRRR,... - Copy one channel from scratchpad to another channel 
SYNOPSIS 

SSRRRRtoRRRR(src, dst, n) 

SSRRRRtoGGGG(src, dst, n) 

SSRRRRtoBBBB(src, dst, n) 

SSRRRRtoAAAA(src, dst, n) 

SSGGGGtoRRRR(src, dst, n) 

SSGGGGtoGGGG(src, dst, n) 

SSGGGGtoBBBB(src, dst, n) 

SSGGGGtoAAAA(src, dst, n) 

SSBBBBtoRRRR(src, dst, n) 

SSBBBBtoGGGG(src, dst, n) 

SSBBBBtoBBBB(src, dst, n) 

SSBBBBtoAAAA(src, dst, n) 

SSAAAAtoRRRR(src, dst, n) 

SSAAAAtoGGGG(src, dst, n) 

SSAAAAtoBBBB(src, dst, n) 

SSAAAAtoAAAA(src, dst, n) 
pixel *src, *dst; register n; 

DESCRIPTION 

These procedures copy 4*n values from the specified channel of the src pixel array to the destination pixel 
array. The source and the destination should be aligned to a multiple of 4. This is an optimized version of 
CCCopy. 

LIBRARY 

libpta 

SEE ALSO 

SSCopyRGBA(3C), SSCopyRGB ALUT(3C), CICopy(3C) 

DIAGNOSTICS 

The number of pixels copied is returned in acc. 
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NAME 

SSRtoRGBA, 

SSGtoRGBA, 

SSBtoRGBA, 

SSAtoRGBA - Copy one channel from scratchpad to 4 channels 
SYNOPSIS 

SSRtoRGBA(src, dst, n) 

SSGtoRGBA(src, dst, n) 

SSBtoRGBA(src, dst, n) 

SSAtoRGBA(src, dst, n) 
pixel *src, *dst; register n; 

DESCRIPTION 

These procedures copy 4*n values from the specified channel of the src pixel array to the destination pixel 
array. Each value is replicated in all 4 components of the of the destination array. The source and destina¬ 
tion arrays should be aligned to a multiple of 4. This is an optimized version of CCCopy. 

LIBRARY 

libpta 

SEE ALSO 

SSCopyComp(3C), SSCopyRGBALUT(3C), CICopy(3C) 

DIAGNOSTICS 

The number of pixels copied is returned in acc. 
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NAME 

SSRtoRGBALUT, 

SSGtoRGBALUT, 

SSBtoRGBALUT, 

SSAtoRGBALUT - Copy one channel from scratchpad to 4 channels through a color table 
SYNOPSIS 

SSRtoRGBALUT(src, dst, n, table) 

SSGtoRGBALUT(src, dst, n, table) 

SSBtoRGBALUT(src, dst, n, table) 

SSAtoRGBALUT(src, dst, n, table) 
pixel *src, *dst; register n; 
pixel tablet]; 

DESCRIPTION 

These procedures copy n values from the specified channel of the src pixel array to the destination pixel 
array. Each value from the source array is looked up in the 4-way color table map to yield the component 
values of the result 

The map table is actually four tables: TR, TG, TB, TA. The map table should point to the untesselated 4- 
way value TR[0], TG[0], TB[0], TA[0]. The address passed should be the address of the Oth element in 
this table. If the source array contains negative values, the table should extend backward. 

The source and destination arrays should be aligned to a multiple of 4. 

LIBRARY 

libpta 

SEE ALSO 

PirlMapComp(3H) 

PWMap(3C) 

SSCopyComp(3C), SSCopyRGBA(3C), CICopy(3C) 
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NAME 

SSMerge - merge partial scanline from scratchpad over scratchpad 

SSMergeln - scratchpad to scratchpad merge using IN operator 

SSMergeOut - scratchpad to scratchpad merge using OUT operator 

SSMergeOver - scratchpad to scratchpad merge using OVER operator 

SSMergeAtop - scratchpad to scratchpad merge using ATOP operator 

SSMergeUnder - scratchpad to scratchpad merge using UNDER operator 

SYNOPSIS 

SSMerge(Fptr, Bptr, Tptr, JKptr, n, Lf, Lb) 
pixel *Fptr, *Bptr, *Tptr, * JKptr; register n, Lf, Lb; 

SSMergeIn(Fptr, Bptr, Tptr, n, Lf, Lb) 
pixel *Fptr, *Bptr, ♦Tptr; register n, Lf, Lb; 

SSMergeOut(Fptr, Bptr, Tptr, n, Lf, Lb) 
pixel *Fptr, *Bptr, *Tptr; register n, Lf, Lb; 

SSMergeOver(Fptr, Bptr, Tptr, n, Lf, Lb) 
pixel *Fptr, *Bptr, *Tptr; register n, Lf, Lb; 

SSMergeAtop(Fptr, Bptr, Tptr, n, Lf, Lb) 
pixel *Fptr, *Bptr, Tptr; register n, Lf, Lb; 

SSMergeUnder(Fptr, Bptr, Tptr, n, Lf, Lb) 
pixel *Fptr, *Bptr, *Tptr; register n, Lf, Lb; 

DESCRIPTION 

SSMerge merges n pixels from one scratchpad location with another, writing the result into a third 
scratchpad buffer, Tptr. The compositing expression is 
Lf* F opL£*B. 

The equation being computed is 

Tptr = (jO + j 1 *Lb[a] *B [a])*L/*F + (kO + kl*L/Ia]*F[a])*LZ>*B 
where F and B are the pixel structs associated with Fptr and Bptr, Lf and Lb are 4-way coefficients for the 
foreground and background, and x[a] designates the alpha component of x. 

JKptr points to four words in scratchpad holding {jO, jl,kO,kl} (these are all 11-bit quantities). Sample 
settings are {1.0E, 0,1.0E, -1.0E} for Over, {0,1.0E, 0,0) for In. 

The current implementation of the general merge takes about forty ticks per pixel. The shorthand operators 
can reduce this to as little as six ticks per pixel. Routines are written to optimize code for these operators: 
Over, Out, Atop, and Under. These operations may be accessed using the shorthand calls as described in 
the synopsis. 

The following equations are implemented for each shorthand operator, using the same notation as the gen¬ 
eral merge. 

SSMergeln: Tptr = L/*F*L6[a]*B[a] 

SSMergeOut: Tptr = Lf* F*(l -L6[a]*B[a]) 

SSMergeOver: Tptr = Lf* F + (1 - F[a])*Zi>*B 
SSMergeAtop: Tptr = (L6[a]*B[a])*L/*F + (1 - L/Ia]*F[a])*L6*B 
SSMergeUnder: Tptr = (1 - L6[a]*B[a])*L/*F + Lb* B 

LIBRARY 

libpta 

SEE ALSO 

SSCopy(3C), 

Compositing Digital Images, by Porter and Duff. 
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NAME 

SSPaint - paint partial scanline from scratchpad over scratchpad 

SSPaintOver - SSPaint using OVER operator 

SSPaintCopy - merge pixels using spad matte 

SYNOPSIS 

SSPaint(Fptr, Bptr, Tptr, matte, JKptr, count, La, Finer, matteincr) 
pixel *Fptr, *Bptr, *Tptr, *matte, * JKptr; register count, La; 
index Finer, matteincr; 

SSPaintOver(Fptr, Bptr, Tptr, matte, count, La, Finer, matteincr) 
pixel *Fptr, *Bptr, *Tptr, *matte; register count, La; 
index Finer, matteincr; 

SSPaintCopy(Fptr, Bptr, Tptr, matte, count, La, Finer, matteincr) 
pixel *Fptr, *Bptr, *Tptr, ♦matte; register count, La; 
index Finer, matteincr; 

DESCRIPTION 

SSPaint paints count foreground pixels over count background pixels with regard to an independent matte, 
writing the result into a Tptr scratchpad buffer. The compositing expression being calculated is 

((F op B) IN A) PLUS (B OUT A). 

The equation being computed is therefore 

Tptr = (JO + jl*B[a])*a*La*F + (1 - a*La*(l - kO - kl*F[a]))*B 

where F and B are the pixel structs associated with Fptr and Bptr, La is a coefficient for the independent 
matte a, and x[a] designates the alpha component of x. 

JKptr points to four words in scratchpad holding {jO, j 1, kO, kl} (these are all 11-bit quantities). Sample 
settings are {1.0E, 0,1.0E, -1.0E} for Over, {0,1.0E, 0,0} for In. 

SSPaintOver paints count pixels from scratchpad over frame buffer. The equation computed is 
Tptr = a*La*F + (1 - a*La*F[a])*B, 

where F and B are the pixel structs associated with Fptr and Bptr, La is a coefficient for the independent 
matte a, and x[a] designates the alpha component of x. 

SSPaintCopy merges count foreground pixels from the scratchpad Fptr inside the scratchpad matte with 
count background pixels from the scratchpad Bptr outside the scratchpad matte into the target scratchpad 
Tptr. 

Tptr = a*La*F + (1 - a*La)*B 

where F and B are the pixel structs associated with Fptr and Bptr, La is a coefficient for the independent 
matte a, and x[a] designates the alpha component of x. 

LIBRARY 

libpLa 

SEE ALSO 

SSCopy(3C) 

Compositing Digital Images, by Porter and Duff. 
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NAME 

SSShuffleBroadcast - SSCopy, broadcasting single component of src to dst 
SSShuffleXbar - SSCopy using specified roffset,goffset, boffset, aoffset transform 

SSShuffleRot - SSCopy with specified channel rotation 

SYNOPSIS 

SSShuffleRot(src, dst, count, rotation) 
pixel *src,*dst; register count; index rotation; 

SSShuffleBroadcast(src, dst, count, component) 
pixel *src,*dst; register count; index component; 

SSShuffleXbar(src, dst, count, roffset, gofTset, boffset, aoffset) 
pixel *src,*dst; register count; index roffset,goffset,boffset,aoffset; 

DESCRIPTION 

SSShuffleRot copies from scratchpad to scratchpad using the specified channel rotation rotation', count pix¬ 
els are copied. 

0 RGBA->RGBA (copy) 

1 RGBA->GBAR 

2 RGBA->BARG 

3 RGBA->ARGB 

SSShuffleBroadcast copies only the specified component from scratchpad to scratchpad: 

0 R 

1 G 

2 B 

3 A 

count components are copied. 

SSShuffleXbar forms a general purpose crossbar for movement of scratchpad components into the 
scratchpad destination. The index registers hold offsets, 0 for roffset to 3 to aoffset, for the destinations of 
the individual components of the pixel. For example, the roffset component of the src pixel is copied to dst 
address + roffset’, count pixels are copied. Thus, this procedure can perform the function of the two previ¬ 
ous procedures. However, the other two are faster. 

LIBRARY 

libpta 

SEE ALSO 

SFCopy(3C) 

DIAGNOSTICS 

The number of pixels copied is returned in acc. 
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NAME 

SYCopy 

SYNOPSIS 

SYCopy(buf, cnt, dest_addr, priority) 
int *buf; register cnt, dest addr, priority 

DESCRIPTION 

This routine copies pixels from the scratchpad to the yapbus. buf (bO) points to the base of the scratchpad 
buffer to be sent cnt (rO) holds the number of pixels to be sent out, and should be a multiple of 16. 
dest_addr (rl) has the receiver address that data is to be sent to, and must be a number from 1 through 15. 
priority (r2) has the transmitter priority level, and must be a number from 0 through 15. 

Pixels are transmitted at a rate of two pixels per CPU tick. 

LIBRARY 

libpt.a 

SEE ALSO 

YSCopy.3c 

DIAGNOSTICS 

A non-zero value is returned in acc if a transmission problem occurs. 
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NAME 

AllocTB 

ReAllocTB 

InqTB 

DeallocTB 

InitTB 


- initializes a tile block in frame buffer memory 

- reuses a previously allocated tile block 

- gather information on tile block 

- deallocates a tile block 

- cleans out the tile block area 


SYNOPSIS 

int * AllocTB(firsttile, tilewidth, tileheight) 
register firsttile, tilewidth, tileheight; 

int * ReAllocTB(tb, firsttile, tilewidth, tileheight) 
int *tb; register firsttile, tilewidth, tileheight; 

InqTB (tb) 
int *tb; 

DeallocTB(tb) 
int *tb; 

InitTB () 

DESCRIPTION 

A tile block is a linear array of 32x32 pixel tiles in frame buffer memory. The tile block data structure lets 
the Chap and video controller agree on a rectangular allocation of the linear memory. AllocTB initializes a 
tile block for subsequent creation of pixel windows. Note that, in spite of the routine name, this does not 
allocate the space - presumably that has been done in the host, firsttile is the first of the linear tiles (upper 
left comer); tilewidth is the number of tiles across the rectangular block; tileheight is the number of tiles 
down the rectangular block; the tile block pointer is returned. 

ReAllocTB reuses a previously allocated tile block, firsttilerm , tilewidth , and tileheight have the same 
meanings as in AllocTB. 

InqTB does the inverse of AllocTB , taking a tb and returning firsttile, tilewidth , and tileheight. 

DeallocTB deallocates an open tile block. 

InitTB clears out all tile block structures to offer a fresh start 

LIBRARY 

libpta 

SEE ALSO 

PW(3C) 

DIAGNOSTICS 

AllocTB and ReAllocTB return -1 in acc on failure (no more space for tile blocks) and 0 on success. 
DeallocTB and InqTB return -1 in acc on failure (invalid tb), and 0 on success. 
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NAME 

TBCopy - copy between tile blocks in frame buffer memory 

FFCopy - copy a single tile between locations in frame buffer memory 

SYNOPSIS 

#include <chap/pbus.h> 

TBCopy(srctb, dsttb, chanmask) 

Int *srctb, * dsttb; register channelmask; 

FFCopy(srctile, dsttlle, channelmask) 
int srctile, dsttlle; register channelmask; 

DESCRIPTION 

The routines TBCopy and FFCopy perform a fast copy of whole tiles of image memory without using 
scratchpad buffers. FFCopy copies a single tile to another location in image memory, where the tiles are 
referred to by number. Somewhat friendlier is TBCopy, which copies an entire tile block (as discussed in 
TB(3C)), taking as arguments a source and destination tile block. No checking is performed to assure that 
the two tile blocks are of like size. 

The channelmask argument to both routines may be used to restrict the copy to a subset of the pixel chan¬ 
nels. The bit masks PBUSCSR_RED, PBUSCSRjGREEN, PBUSCSR_BLUE and PBUSCSR_ALPHA, 
defined in <chap/pbus.h>, are bitwise-or’ed to specify the requisite channels. No crossbar-like interchan¬ 
nel copying is supported. 

LIBRARY 

libpta 

SEE ALSO 

PW(3C), TB(3Q 


Release 1.2 


October 8,1986 


1 



YFCOPY (3C) 


Pixar Programmer’s Manual 


YFCOPY (3C) 


NAME 

YFCopy 

SYNOPSIS 

YFCopy(tile, chanmask, addr) 
int *tile; register chanmask, addr 

DESCRIPTION 

This routine copies pixels from the yapbus to the framebuffer, tile (bO) holds the framebuffer tile number 
to be filled in from the yapbus. chanmask (rO) holds the channel mask to be used when transferring data to 
the framebuffer, addr (rl) has the receiver address that is to be used, and must be a number from 1 through 
15. 

Pixels are received at a rate of one pixel per CPU tick. Tiles are filled in using 32 pixel X access. 

LIBRARY 

libpLa 

SEE ALSO 

FYCopy.3c 

DIAGNOSTICS 

A non-zero value is returned in acc if a transmission problem occurs. 
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NAME 

YSCopy 

SYNOPSIS 

YSCopy(buf, cnt, dest_addr, priority) 
int *buf; register cnt, dest_addr 

DESCRIPTION 

This routine copies pixels from the yapbus to the scratchpad. buf(bO) points to the base of the scratchpad 
buffer to be filled, cnt (rO) holds the number of pixels to be received, and should be a multiple of 16. 
dest_addr (rl) has the receiver address to be used, and must be a number from 1 through 15. 

Pixels are received at a peak rate of one pixel per CPU tick. 

LIBRARY 

libpta 

SEE ALSO 

SYCopy.3c 

DIAGNOSTICS 

A non-zero value is returned in acc if the transmitter disappears after starting a transfer. 
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NAME 

libpx - introduction to Pixar image transformation library 

DESCRIPTION 

libpx contains routines to geometrically transform images. There are procedures to change the size of an 
image using linear, quadratic or cubic interpolation. A procedure exists to decrease the size of an image. 
Other procedures can be used to rotate and warp images. 

LIBRARY 

/usr/pixar/chap/lib/libpx.a 
SEE ALSO 

intro(3C), libcolor(3C), libpG(3C), libpip(3C), libpm(3C), libpt(3C) 

LIST OF FUNCTIONS 


Name 

Page 

Description 

PWResize 

PWResize(3C) 

- resize source pixel window to destination pixel window 

PWShear 

PWShear(3C) 

- Shear a pixel window 

SSHalve 

SSHalve(3C) 

- average 2 scanlines down to one of half size 

hdl 

SSScale(3C) 

- use no filter to scale down horizontally 

hd2 

SSScale(3C) 

- use linear filter to scale down horizontally 

hd4 

SSScale(3C) 

- use cubic filter to scale down horizontally 

hul 

SSScale(3C) 

- use no filter to scale up horizontally 

hu2 

SSScale(3C) 

- use linear filter to scale up horizontally 

hu4 

SSScale(3C) 

- use cubic filter to scale up horizontally 

setmagltable 

SSScale(3C) 

- set up filter coefficients for subsequent hul or vul 

setmag2table 

SSScale(3C) 

- set up filter coefficients for subsequent hu2 or vu2 

setmag4table 

SSScale(3C) 

- set up filter coefficients for subsequent hu4 or vu4 

setminl table 

SSScale(3C) 

- set up filter coefficients for subsequent hdl or vdl 

setmin2table 

SSScale(3C) 

- set up filter coefficients for subsequent hd2 or vd2 

setmin4table 

SSScale(3C) 

- set up filter coefficients for subsequent hd4 or vd4 

stwarp 

stwarp(3C) 

- warp source to target 

stwarptable 

stwarptable(3C) 

- initialize quadradic warping table 

vdl 

SSScale(3C) 

- use no filter to scale down vertically 

vd2 

SSScale(3C) 

- use linear filter to scale down vertically 

vd4 

SSScale(3C) 

- use cubic filter to scale down vertically 

vul 

SSScale(3C) 

- use no filter to scale up vertically 

vu2 

SSScale(3C) 

- use linear filter to scale up vertically 

vu4 

SSScale(3C) 

- use cubic filter to scale up vertically 
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The routine hu4 loops Ow times, one for each output pixel, using the count table to indicate which source 
pixels contribute to that output pixel, and using the coefficient table to recover the weighting factors for 
each source pixel contribution. 

The inner loop takes 11 ticks per output pixel. The total time is approximately (1 l*0w+4O) ticks. 


The hd4 routine takes an input scanline of Iw+6 pixels and produces an output scanline of Ow pixels. The 
Iw pixels of the input scanline are normally padded by 3 null pixels on each end. The coefficient table and 
count table must have been produced by the setmin4table routine. The hd4 routine leaves these tables 
untouched. The value Ow is approximately floor[5+^/e*(/w-l)]; the input value passed in rl should be 
the value of Ow returned by setmin4table . 

The routine hd4 loops for each of the Iw input pixels, using the count table to indicate which target pixels 
get contributions from that source pixel, and using the coefficient table to recover the weighting factors for 
each source pixel contribution. 

The inner loop takes 17 ticks per input pixel. The total time is approximately (17*/w+40) ticks. 


The 21 vu4 routine takes an input scanline of width pixels and produces output scanlines. The routine is 
intended for interleaved use with a horizontal scaling routine (e.g., hu4 , hd4) for the second pass of two 
dimensional scaling without the use of an intermediate picture buffer. The only intermediate storage is 
pointed to by scanlineptr. This is an array of 3 scanline pointers, pointing to the last three source scanlines. 

To effect this interleaved 2D scaling, the vu4 routine returns several values. The base registers pointing to 
the coefficient table and count table are incremented, and their values at the end of one call to vu4 should 
be the same as their input values at the start of the next call. On output, rl holds a flag indicating whether 
the target scanline has been completed. On output, r2 holds a flag indicating whether another input scanline 
is needed. On output, r3 holds a flag indicating whether the output scanline must be zeroed before reuse. 
In fact, vu4 always produces an output scanline (rl=l), and never requires it to be zeroed (r3=0). These 
outputs are done this way for compatibility with vd4 . Thus rl = and r3 = 0. 

The coefficient table and count table for vu4 must have been produced by the setmag4table routine. The 
vu4 routine leaves these tables untouched. The value width is presumably the output width of the horizon¬ 
tal scaling process. 

The routine loops for each of the width output pixels, using this last input and three previous ones to contri¬ 
bute to the current pixel of the target scanline, and using the coefficient table to recover the weighting fac¬ 
tors for each contribution. 

The inner loop takes 15 ticks per output pixel. The total time is approximately (15*<9w+50) ticks. 

The vd4 routine takes an input scanline of width pixels and possibly produces an output scanline. The rou¬ 
tine is intended for interleaved used with a horizontal scaling routine (e.g., hu4, hd4) for the second pass of 
two dimensional scaling without the use of an intermediate picture buffer. The only intermediate storage in 
pointed to by scanlineptr. This is array of 3 scanline pointers, pointing to the next three target scanlines to 
be produced. 

To effect this interleaved 2D scaling, the vd4 routine returns several values. The base registers pointing to 
the coefficient table and count table are incremented along, and their values at the end of one call to vd4 
should be the same as their input values at the start of the next call. On output, rl holds a flag indicating 
whether the target scanline has been completed. It is possible that more input scanlines are necessary 
before this output can be finished. On output, r2 holds a flag indicating whether another input scanline is 
needed. On output, r3 holds a flag indicating whether the output scanline must be zeroed before reuse. In 
fact, vd4 always needs another input scanline (r2=l). These outputs are done this way for compatibility 
with vu4. 

The coefficient table and count table for vd4 must have been produced by the setnun4table routine. The 
vd4 routine leaves these tables untouched. The value width is presumably the output width of the 
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horizontal scaling process. 

The routine loops for each of the width output pixels, using this last input scanline to contribute to the 
current pixel of the target scanline and the next three after that, and using the coefficient table to recover 
the weighting factors for each contribution. 

The inner loop takes 16 ticks per output pixel. The total time is approximately (16*0w+5O) ticks. 

The setmag4table routine sets up filter coefficients specifically for the hu4 and vu4 routines. Two table are 
filled: the counttable holds a count of the number of output pixels that map back into each of the Iw+l 
intervals of the input scanline; the coefftable holds sets of four filter coefficients for each of those output 
pixels. An output pixel is computed by summing the products of the four filter coefficients with the four 
consecutive input pixels that straddle the current interval. 

Filter coefficients come in sets of four because the filter (see filtertable.s) spans four pixels. The current 
filter of choice is a Catmull-Rom basis function. 

The setmag4table routine takes 25 ticks for each output pixel. 


The setmin4table routine sets up filter coefficients specifically for the hd4 routine. Two tables are filled: the 
counttable holds a count of the number of input pixels that map into each of the Ow+ 1 intervals of the out¬ 
put scanline; the coefftable holds sets of four filter coefficients for each of those output pixels. An input 
pixel contributes to four consecutive output pixels which straddle the current interval by multiplying it by 
this set of four filter coefficients. An output pixel is accumulated with as many input contributions as 
necessary. 

Filter coefficients come in sets of four because the filter (see filtertable.s) spans four pixels. The current 
filter of choice is a Catmull-Rom basis function. 

The setmin4table routine takes 27 ticks for each input pixel. 

LIBRARY 

libpx.a 

DIAGNOSTICS 

Both the setmag4table and setmin4table routines return negative values in acc if the scale is out of the 
[0,1.0E] range. 
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NAME 

stwarp - warp source to target 

SYNOPSIS 

stwarp(inputwidth, outputwidth, outputofTset, src, dst, hptr) 
register inputwidth, outputwidth, outputofTset; 
pixel *src, *dst; 
double *hptr; 

DESCRIPTION 

stwarp takes an input scanline pointed to by iptr and an array of targets, double precision values pointed to 
by hptr, which indicate where each of the input pixels maps into the output scanline. The routine then dis¬ 
torts the incoming pixel values as appropriate to create pixel values for the output pixel array pointed to by 
dst. The routine is given the length of the input array inputwidth and the length outputwidth and offset out- 
putojfset of the output array. 

The routine will write a double precision number immediately preceding and immediately after the input 
array of targets, so the input array must allow for 2 words of padding at each end. The routine also expects 
a padded input scanline, though nothing will be written into the padding. The calling program should fill 
the padding with whatever value, most likely (0,0,0,0), is the appropriate border color. Note that in each 
case, the pointer to the array points beyond the initial padding. 

The idea here is that an input array represents pixel values at the discrete sample points (0.5, 1.5, 2.5, ... 
inputwidth -.5). Each of these inputwidth samples will be mapped to a target space according to the target 
array (t(0.5), t(1.5), t(2.5),..., t( inputwidth -.5)). The assumption at the endpoints is that t(0) = outputoffset 
and outputwidth+outputojfset = t(inputwidth). 

Using linear interpolation where the targets are far apart and area averaging where the targets are close 
together, the input is squashed and stretched to produce an anti-aliased output array. 

LIBRARY 

libpx.a 
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NAME 

stwarptable - initialize quadratic warping table 

SYNOPSIS 

stwarptable(width, height, yO, yl, xO, xl, hptr) 
register width, height, yO, yl, xO, xl; 
double *hptr; 

DESCRIPTION 

stwarptable produces an array of targets for subsequent use by the routine stwarp. 

This routine relates to the math used for the SIGGRAPH ’85 warping demo, so a little background is 
appropriate. The intended interaction is to move a point (xO, yO) of the source picture to a point (xl, yl) of 
the target picture while all perimeter points of the window stay fixed. Assume the window goes from 0 to 
w in x and from 0 to h in y. 

Consider the x pass. We have some function f(x) = a+b*x+c*x*x (0 <= x <= w) at each line y which 
warps quadratically in x. This is specified by {f(0)=0; f(w)=w; f(i)=j;}; in other words, the right and left 
stay fixed while i moves to j. 

So what are i and j for any line y? They are completely determined by the need to warp point xO to point 
xl at line yO. This me'ets the first half of our goal of mapping (xO, yO ) to (xl, yl). Thus, for 0 <= y <= h, 
i(y) = xO; j(y) = d+e*y+f*y*y constrained by {j(O)=*0; ](y0)=xl\ j(h)=x0}; in other words, at the top and 
bottom the point xO stays put, while xO moves to xl at line yO. 

The y pass is similar, except that now we guarantee that yO moves to yl at column xl . 

The routine stwarptable accepts the picture width and height, with the understanding that xO moves to xl 
on line yO. The routine then takes the line y and produces an array of output locations (double precision) in 
which each of the width input pixels maps to in the output image. 

For the y pass of and two-pass method for warping, the x’s and y’s must naturally be reversed. 

LIBRARY 

libpx.a 
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NAME 

PWResize - resize source pixel window to destination pixel window 

SYNOPSIS 


PWResize (srcpw, dstpw, hcoefftable, hcounttable, vcoefftable, vcounttable, 
vinput, voutput, rest, hinput, hextent, vextent, how, hjO, vow, vjO) 
int *srcpw, *dstpw; 
int *hcoefftable,*hcounttable; 
int *vcoefftable,*vcounttable; 
index pixel **vinput,**voutput; 
index pixel **rest; 

/* horizontal input buffer for FxSCopy */ 

/* horizontal/vertical filter extents (2 or 4) */ 

/* output width/offset from setfmin,mag] table */ 

/* output width/offset from set[min,mag]table */ 


index pixel *hinput; 
register hextent,vextent; 
register how,hjO; 
register vow,vjO; 


DESCRIPTION 

PWResize is an assembly code call for resizing an image. This routine calls the SSScaleQC) routines in 
libpx.a for horizontal and vertical scaling of the image. The routines are fast and need no intermediate 
off-screen framebuffer storage, unlike PWRotate, but they are somewhat complicated to use. 


This routine needs several temporary areas of scratchpad memory. 


The coefficient and counttables are produced by the set[min,mag][2,4]table.s routines. These routines are 
explained in SSScale(3C). Each of these scaling table routines takes integer and fractional scales and pro¬ 
duces a magnification (minification) coefficient table, a count table, and two additional values. The caller 
must have allocated enough space for these tables, usually via Chad. 

The first variable is the modified output width, representing the actual number of pixels to write, some of 
which will be clipped by the pixel window. The scaling routine produces inaccurate values toward the 
edges of the window, and this slightly higher value makes sure these values will lie outside the pixel win¬ 
dow. The second variable is offset, a negative value, which is added to the starting pixel position in the 
scanline, so the valid pixels start at the zeroth position. After calling the appropriate 
set[min,mag][2,4]table routine, these values are saved, then passed to PWResize , as the horizontal output 
width (how), the horizontal offset (hjO), the vertical output width (vow), and the vertical offset (v jO). 

The vertical scaling parameters may need several additional scanlines of scratchpad memory in order to 
create output scanlines during resizing. The scanline buffers are reused by the vertical scaling routine. 
The reuse of buffers is controlled by the scaling routine, so it is only necessary to allocate the buffers and 
start it off. 


The number of input scanline buffers and out scanline buffers is dependent on the filter size used, and the 
direction of scaling. 

To handle overlapping windows, PWResize might swap the sense of “h” and “v,” and use vertical scan¬ 
lines. This means that the buffers must be allocated to hold the maximum of the horizontal and vertical 
widths. 


If maxow is the maximum of how and vow, and maxiw is the maximum of hiw and viw, the buffers should 
be: vinput a pointer to a pointer to maxow pixels; voutput a pointer to a pointer to maxow pixels; rest a table 
of three pointers, each to maxow pixels (see below); and hinput a pointer to maxiw pixels. 

WARNING: The next paragraph will be infinitely clearer if you read and understand the SSScale( 3C) 
manual page in this section. 

Consider the case of a filter size of four, and vertical scale greater than one (vu4). This routine takes four 
input scanlines and creates one output scanline. Since PWResize requires pointers to pointers to scanlines, 
a small buffer area must be allocated. Space for each of these scanlines, input and output, must be allo¬ 
cated, as well as the other areas described in this paragraph. Notice that the vinput, voutput and rest param¬ 
eters are pointers to pointers to pixels. The easiest thing is to allocate a spad of one word for the input, 
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output, and three words for the rest buffer. The pointer to the input scanline, (after horizontal scaling), is 
placed in the input word. This now a pointer to the pointer to the input scanline. The pointer to the output 
scanline, (produced by vertical scaling), is placed in the output word. This now a pointer to the pointer to 
the output scanline. The additional three input scanline pointers are placed in the rest buffer. The address 
of the input scanline before horizontal scaling is placed in hinput. 

For scaling down (vd4), the rest buffer stores pointers to the additional output scanlines. Instead of placing 
the pointers to the additional input scanlines in the rest buffer, the pointers of the output scanlines are 
placed in the rest buffer. 

LIBRARY 

libpx.a 

SEE ALSO 

PirlResize(3H) 

ERRORS 

Both pixel windows must belong to the same chap. 
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NAME 

PWShear - Shear a pixel window 

SYNOPSIS 

#include <chad.h> 

#include <pirl.h> 

PWShear4, PWShear2 
parameters: 
bO - srcpw 
bl - dstpw 
b2 - bufferA 
b3 - bufferB 
b4 - bufferC 
b5 - bufferD 

rO - scalef (fractional part (16-bits)) 

rl - scalei (integer part) 

r2 - offsetf (fractional part (16-bits)) 

r3 - offseti (integer part) 

r4 - incrementf (fractional part (16-bits)) 

r5 - increment! (integer part) 

r6 - access mode 

rl - clr 

r8 - width 

r9 - height 

DESCRIPTION" 

PWShear4 and PWShear 2 shear a source pixel window and places the result in a destination pixel window. 
PWShear4 uses a cubic resampling filter with a filter extent of 4. PWShear2 uses a linear resampling filter 
with a filter extent of 2. 

srcpw defines the source pixel window to shear, 
dstpw defines the the destination pixel window. 

Four scratchpad buffers are required. Their sizes must be at least as large as the following: 

bufferA - 4 * (input_width+6) words 

bufferB - 4 * (scale* (input_width+3)+l) words 

bufferC - filter_extent * (max(scale, l)*(input_width+3)+l) words 

bufferD - max(scale, l)*(input_width+3)+l words 

scalef, scalei specify a scale factor for resizing each scanline 

Additional parameters are: 

offsetf, offseti specify the offset for the first destination scanline. 

incrementf, increment specifes the incremental offset for each additional destination scanline, 
access specifies the scanline access directions for the src and dst. 
access must be one of the following defined options: 


#define XIN.XOUT 0 

#define XBACKWARDSIN_XOUT 1 

#define YIN_XOUT 2 

#define YB ACKW ARDS INJXOUT 3 

#define YIN_YOUT 4 

#define YB ACKW ARDS IN_YOUT 5 

#define XLN_YOUT 6 

#define XBACKWARDSIN_YOUT 7 


clr is a flag wich specifies whether shear should clear out its borders, 
iw, ih specify the input width and height of 
the src window with respect to 
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the access mode specified (above). 

FILES 

/usr/pixar/chap/src/lib/libpx/pwshear.s 

LIBRARY 

libpx.a 

SEE ALSO 

Rotate(l), PirlRotate(3h), PirlAffine(3h), PirlShear(3c) 
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NAME 

SSHalve - average 2 scanlines down to one of half size 

SYNOPSIS 

SSHalve(srcl, src2, dst, n) 
pixel *srcl, *src2, ♦dst; register n; 

DESCRIPTION 

SSHalve takes two scanlines srcl and src2 of length 2n pixels and averages them down to one scanline dst 
of length n pixels. The computation is simply 

dst[ i] = Ocl[2i] + srcl[2i+l] + src2[2i] + src2[2i+l] + 2)/4 

for i between 0 and n- 1. 

LIBRARY 

libpx.a 

SEE ALSO 

SSCopy(3C) 
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NAME 

hu4 

hd4 

vu4 

vd4 

setmag4table, 

setmin4table 

hu2 

hd2 

vu2 

vd2 

setmag2table, 

setmin2table 

hul 

hdl 

vul 

vdl 

setmagl table, 
setminl table 


- Use cubic filter to scale up horizontally 

- Use cubic filter to scale down horizontally 

- Use cubic filter to scale up vertically 

- Use cubic filter to scale down vertically 

- set up filter coefficients for subsequent hd4 or vd4 

- Use linear filter to scale up horizontally 

- Use linear filter to scale down horizontally 

- Use linear filter to scale up vertically 

- Use linear filter to scale down vertically 

- set up filter coefficients for subsequent hd2 or vd2 

- Use no filter to scale up horizontally 

- Use no filter to scale down horizontally 

- Use no filter to scale up vertically 

- Use no filter to scale down vertically 

- set up filter coefficients for subsequent hdl or vdl 


SYNOPSIS 

hu4(src, dst, coelTtable, counttable, Iw, Ow) 
pixel *src, *dst, ‘coefftable, *counttable; 
register Iw, Ow; 

hd4(src, dst, coefftable, counttable, Iw, Ow) 
pixel *src, *dst, ‘coefftable, ‘counttable; 
register Iw, Ow; 


vu4(srcptr, dstptr, coefftable, counttable, width, scanlineptr) 
pixel “srcptr, “dstptr, *coefftable, *counttable; 
register width; 
index pixel *scanlineptr[3]; 

vd4(srcptr, dstptr, coefftable, counttable, width, scanlineptr) 
pixel “srcptr, “dstptr, ‘coefftable, ‘counttable; 
register width; 
index pixel *scanlineptr[3]; 

setmag4table(coefftable, counttable, Iw, scale, reciprocal, outputoffset) 
pixel ‘coefftable, ‘counttable; 
register Iw, scale, reciprocal; 
register double outputoffset; 

setmin4table(coefftable, counttable, Iw, reciprocal, scale, outputoffset) 
pixel ‘coefftable, ‘counttable; 
register Iw, reciprocal, scale; 
register double outputoffset; 

hu2(src, dst, coefftable, counttable, Iw, Ow) 
pixel ‘src, ‘dst, ‘coefftable, ‘counttable; 
register Iw, Ow; 

hd2(src, dst, coefftable, counttable, Iw, Ow) 
pixel *src, *dst, ‘coefftable, ‘counttable; 
register Iw, Ow; 
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vu2(srcptr, dstptr, coefftable, counttable, width, scanlineptr) 
pixel “srcptr, “dstptr, ‘coefftable, ‘counttable; 
register width; 
index pixel *scanlineptr[l]; 

vd2(srcptr, dstptr, coefftable, counttable, width, scanlineptr) 
pixel “srcptr, “dstptr, ‘coefftable, ‘counttable; 
register width; 
index pixel *scanlineptr[l]; 

setmag2table(coefftable, counttable, Iw, scale, reciprocal, outputoffset) 
pixel ‘coefftable, ‘counttable; 
register Iw, scale, reciprocal; 
register double outputoffset; 

setmin2table(coefftable, counttable, Iw, reciprocal, scale, outputoffset) 
pixel ‘coefftable, ‘counttable; 
register Iw, reciprocal, scale; 
register double outputoffset; 

hul(src, dst, coefftable, counttable, Iw, Ow) 
pixel *src, *dst, ‘coefftable, ‘counttable; 
register Iw, Ow; 

hdl(src, dst, coefftable, counttable, Iw, Ow) 
pixel *src, *dst, ‘coefftable, ‘counttable; 
register Iw, Ow; 

vul(srcptr, dstptr, coefftable, counttable, width) 
pixel “srcptr, “dstptr, ‘coefftable, ‘counttable; 
register width; 

vdl(srcptr, dstptr, coefftable, counttable, width) 
pixel “srcptr, “dstptr, ‘coefftable, ‘counttable; 
register width; 

setmagltable(coefftable, counttable, Iw, scale, reciprocal, outputoffset) 
pixel ‘coefftable, ‘counttable; 
register Iw, scale, reciprocal; 
register double outputoffset; 

setminltable(coefftable, counttable, Iw, reciprocal, scale, outputoffset) 
pixel ‘coefftable, ‘counttable; 
register Iw, reciprocal, scale; 
register double outputoffset; 

DESCRIPTION 

The scaling routines come in three different varieties depending on how the filtering is done. Some use 4- 
pixel wide (cubic) filter tables; some use 2-pixel wide (linear) filter tables; some use 1-pixel wide (jaggy) 
filter tables. For each set, there are routines that create the filter coefficients (e.g., setmag4table), routines 
that stretch a single input scanline to a single output scanline for horizontal scaling (e.g., hu4), and routines 
that accept multiple continugous input scanlines to produce a single output scanline for vertical scaling 
(e.g., vu4). 

The hu4 routine takes an input scanline of Iw+6 pixels and produces an output scanline of Ow pixels. The 
Iw pixels of the input scanline are normally padded by 3 null pixels on each end. The coefficient table and 
count table must have been produced by the setmag4table routine. The hu4 routine leaves these tables 
untouched. The value Ow is approximately floor[5ca/e*(/w+3)]; the input value passed in rl should be the 
value of Ow returned by setmag4table . 
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NAME 

chap - Pixar Chap graphics device interface 

SYNOPSIS 

/dev/chap* 

DESCRIPTION 

The chap interface provides access to a Pixar Chap processor (and any associated framebuffer). The dev¬ 
ice interface is actually part of the Dumi device driver, diuni (4), and need not be separately configured. Up 
to eight Chaps may be supported on a single Dumi; they are assigned minor sub-device numbers 1-8. 

In normal use, a Chap device is opened and its diagnostic registers are mapped into the process’s address 
space with an mmap( 2) system call. The file <pixardev/chapreg.h> contains a definition of the registers. 
The registers start at logical offset 0 in the special file. In addition to the diagnostic registers, the chap 
interface supports a number of ioctl commands, described below. 

Only one user may use a chap device at any time, though the user may utilize multiple processes. This 
locking policy is imposed at the time an mmap call is made to map the diagnostic registers into the 
process’s address space. This allows unrelated processes to perform ioctl calls without being interfered 
with by the locking protocol. 

A Chap is autoconfigured by probing the diagnostic registers at boot time. If the driver is successful in 
halting the processor (poking CSR_HALT into the csr), the driver presumes the Chap is present on the 
Sysbus. 

The chap interface has two important features not commonly found in other device drivers. Chap inter¬ 
rupts are transformed into signals, and resource allocation requests are tracked for the instruction, 
scratchpad, and framebuffer memories. The latter facility may, optionally, be provided directly to pro¬ 
grams running in a Chap. 

CHAP INTERRUPTS 

Chap user and breakpoint interrupts are automatically translated into signals by the driver. To enable 
delivery of an interrupt, the CHAPIOSSIG ioctl must be used. This request takes a pointer to a chapsig 
structure specifying an interrupt type (user or breakpoint), a signal to translate the interrupt into, and a pro¬ 
cess id or process group to which the signal should be delivered (a process group is specified with a nega¬ 
tive value). When the specified interrupt is received from the Chap, the associated signal is delivered to the 
process id/group. The previous state for the interrupt is returned by the ioctl call. A zero process id or sig¬ 
nal may be used to disable delivery of an interrupt Signal delivery is automatically revoked when noone is 
using the Chap. 

The CHAPIOGSIG ioctl returns the current state of the interrupt specified in the passed chapsig structure. 

The chapsig structure and associated definitions are found in <pixardev!chapioctl.h>. 

MEMORY MANAGEMENT 

The chap interface implements a first-fit memory management structure for Chap instruction, scratchpad, 
and framebuffer memories. Programs executing on the host or Chap may allocate or free memory, or 
request an allocation at a specific address. 

Prior to any allocation requests, the resource maps must be allocated and initialized with a CHAPIOSCONF 
request This ioctl call takes a pointer to a chapconf structure which, among other things, contains the 
number of entries to be allocated for each resource map. A program may retrieve the information stored in 
this structure with a CHAPIOGCONF request. 

With the resource maps initialized, the following requests are available: 

CHAPIOALLOC Allocate space in a resource map. Size and resource map parameters are specified in 
a chapalloc structure. Maps are identified as CALLOCJFB (framebuffer memory), 
CALLOC_RAM (instruction memory), or CALLOC_SPAD (scratchpad memory). 
Framebuffer requests are specified in tiles (32x32 pixel blocks of memory); instruc¬ 
tion RAM requests are specified in instructions (96-bit locations); and scratchpad 
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CHAPIOFREE 

CHAPIOGET 

CHAPRESET 


requests are specified in pixels (4 16-bit words). Similarly, addresses are in the 
above units. 

Return space previously allocated. The chapalloc structure must specify the map 
address, and size of the block of memory to free. 

Allocate space at a specific address. The parameters are as for CHAPIOALLOC bu 
with an address specified as well. 

Reset a resource map, or maps, to their default state (everything free). An intege 
parameter indicates a specific map, one of CALLOC_FB, CALLOC_RAM, c 
CALLOC_SPAD, or, for all maps, CALLOC_ALL. 


CHAPIOGETMAP Retrieve the contents of the specified resource map. The chapmap structure passe 

as a parameter specifies the map and a place in which the data should be stored. 

As mentioned previously, memory allocation requests may come either from programs executing on tf 
host, or from programs executing on a Chap. In the case of the latter, requests are submitted by placir 
parameters in Sysbus shared data registers and posting a user interrupt. The three requests currently suj 
ported, and their parameters, are: 


Request 

CHAP_ALLOC 

CHAPFREE 

CHAP.GET 


Map 

sysbus<RMAP> 

sysbus<RMAP> 

sysbus<RMAP> 


Address 

sysbus<RADDR> 

sysbus<RADDR> 


Size 

sysbus<RSIZE> 

sysbus<RSIZE> 

sysbus<RSIZE> 


All requests are placed in sysbus<RCMD>. Synchronization is effected by setting sysbus<RRESULT> to ; 
impossible value (commonly -2) prior to posting an interrupt, then waiting for the register to change vali 
Errors are signaled by returning a -1 value. The file <pixarlmman.h> contains definitions for use m imp! 
menting the protocol as well as several macros that may be used in Chap assembly code to carry out t 
requests; see also mman (3C). 

Finally there are several ioctl requests related to Chap memory management facilities. 


CHAPIOMMAN Enable/disable intercepting of user interrupts for interpretation as memory mana£ 
ment requests. Before the device driver will interpret any user interrupts as coi 
mand requests, this call must be made to enable service. An integer parame 
should be set to a non-zero value to enable service, setting it to zero disables servic 


CHAPIOCLEAR Clear the resource allocation maps of any resources allocated by programs runni 

w on ^e Chap. The device driver tracks allocations from Chap programs; this call c 

be used to flush all such requests from one or all resource maps. The map 
specified as the third parameter, as in the CHAPIORESET request. 


FILES 

/dev/chap* Chap special files 

SEE ALSO 

dumi(4), chconfig(8) 


chap%d on dumi%d at %x%s. The specified Chap was configured. The address specified is where 
diagnostic registers were found in the host’s address space. If the configuration was forced for diagno 
purposes (i.e., the device was attached even though the Chap didn’t actually respond), the mess 

(forced) will be displayed. 


chap: bad map arg, %d. A user interrupt from a Chap was received and interpreted as a menr 
management request, but the resource map specified was bogus. 


%s: rmap ovflo, lost [%d,%d). A resource map overflowed as the result of an allocation request, 
results when a map is configured too small and/or allocation requests badly fragment the allocation r 
The indicated map is displayed as well as the segment which could not be placed back in the map. 
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BUGS 


segment is lost until the map is reset or the system is rebooted. 

Since the close routine gets called only on last close of the device, signals may be e^neously delivered to 
an unsuspecting process. For this reason, benign signals are highly recommended, e.g., S G . 

The framebuffer allocation maps should not be on a per-Chap basis, but instead on a per-framebuffer basis 
(when multiple Chaps share a single framebuffer); this requires more mumate knowledge of the Pixar 
hardware configuration than is currently possible. 
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NAME 

dumi 


- Pixar Dumi device interface 


SYNOPSIS 

device dumiO at mbO csr OxaOOOO priority 2 


The dumi driver provides access to a Pixar Dumi device and to the associated devices on die Sysbus. _ 
minor device encoding specifies the devices attached to a Dumi. Minor device 0 is the Dumi itse wi 
each Dumi having 16 minor devices (i.e., minor devices 0-15 are on dumiO, 16-31 on dumil, etc.). Sul 

devices are encoded as follows: 


Minor 

Device 

Description 

Number 

0 

dumi 

Dumi controller 

1 

1-8 

chap 

Chap processor 

8 

9-12 

video 

video controller 

4 

13 

mctrl 

memory controller 

1 

15 

db 

disk buffer (disk window) 

1 


When a Dumi device is opened, its interface registers may be mapped, via virtual memory, into a us 
process's address space with the mmap(2) system caU (address 0 is always the base of the device s reg. 
ters). This allows the user process very high bandwidth to the device with no system call overhead. 


The Dumi register definitions are found in the include file <pixardev/dumireg.h>. 

The driver imposes a single-user locking policy on all devices. That is, each device may have only o 
user at any one time, though a user may have multiple processes sharing a device. This locking po icy 
implemented at the time a process tries to map the device’s associated interface registers into its virti 
address space via mmap. Unfortunately, due to limitations in the design of the system code implementi 
mmap, it is not possible for a program to distinguish “device in use” errors from other potential errors c 

might encounter in using mmap . 


FILES 

/dev/dumi* device special files 


SEE ALSO 

chap(4), db(4), mctrl(4), video(4) 

DIAGNOSTICS , , J . , . , 

Sub-device-specific diagnostics are described under each sub-device s manual entry. 


BUGS 


A user process could possibly cause infinite interrupts, bringing things to a crawl. Currently the disk bu 
device is not supported. 
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NAME 

mctrl 

SYNOPSIS 

/dev/m Ctrl* 


— Pixar memory controller device interface 


DESCRIPTION 

The mctrl interface provides access to a Pixar memory controller. The device interface is actually a part of 
the Dumi device driver, dumi( 4), and need not be separately configured. Only one memory controller is 
supported on a single Dumi; the minor sub-device number is 13. 

In normal use an mctrl device is opened and its interface registers mapped, via virtual memory, into a 
process’s address space with the inmap(2 ) system call (address 0 is always the base of the memory 
controller’s registers). This allows the process very high bandwidth to the device, with no system call 

overhead. 

Only one user may use an mctrl device at any time, though the user may utilize multiple processes. This 
locking policy is imposed at the time an mmap call is made to map the registers into the process s address 

space. 

A memory controller is autoconfigured by probing the registers at boot time. If the driver is successful in 
ini tiali ng the controller (poking the MCCSR.REFX, MCCSRJREFY, MCCSR.REFRD, and MCCSR_REF16 
bits into the csr), the driver presumes the memory controller is present on the Sysbus. 

The memory controller register definitions are normally found in the include file <pixardevlmctrlreg.h>. 


FILES 


/dev/mctrl* 


memory controller device special files 


SEE ALSO 

dumi(4), mctrl(8) 

DIAGNOSTICS „ , . . 

mctrl on dumi%d at %x%s. The specified memory controller was configured. The address specified is 

where the register bank was found in the host’s address space. If the configuration was forced for diagnos¬ 
tic purposes (i.e., the device was attached even though the memory controller didn’t actually respond), the 
message (forced) will be displayed. 
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NAME 

video - Pixar video controller device interface 

SYNOPSIS 

/dev/video* 

DESCRIPTION 

The video interface provides access to a Pixar video controller. The device interface is actually a part oi 
the Dumi device driver, dumi{ 4), and need not be separately configured. Up to four video controllers ma} 
be supported on a single Dumi; they are assigned minor sub-device numbers 9-12. 

In normal use, a video device is opened and its interface registers are mapped, via virtual memory, into i 
process’s address space with the mmap (2) system call (address 0 is always the base of the memon 
controller’s registers). This allows the process very high bandwidth to the device with no system call over 
head. 

Only one user may use a video device at any time, though the user may utilize multiple processes. Thi 
locking policy is imposed at the time an mmap call is made to map the registers into the process’s addres 
space. 

A video controller is autoconfigured by probing the registers at boot time. If the driver is successful ii 
reading the controller’s csr, it presumes the controller is present ©n the Sysbus. 

The video controller register definitions are normally found in the include file <pixardev/videoreg.h>. 

FILES 

/dev/video* video controller device special files 

SEE ALSO 

dumi(4), video(l) 

DIAGNOSTICS 

video%d on dumi%d at %x%s. The specified video controller was configured. The address specified i 
where the register bank was found in the host’s address space. If the configuration was forced for diagno; 
tic purposes (i.e., the device was attached even though the video controller didn’t actually respond), th 
message (forced) will be displayed. 
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NAME 

chap.out - Chap assembler and link editor output 

SYNOPSIS 

#inciude <pixar/reloc.h> 

DESCRIPTION 

chap.out is the output file of the assembler chas( 1) and the link editor chld{ 1). The latter makes chap.out if 
there were no errors and no unresolved external references. Layout information as given in the include file 
is: 


/* 


* Header prepended to each 
*/ 

struct exec { 

long a_magic; 
unsigned a_text; 
unsigned a_data; 
unsigned a_bss; 
unsigned a_syms; 
unsigned a_entry; 
unsigned a_trsize; 
unsigned a_drsize; 


chap.out file. 


/* magic number */ 

/* size of text segment */ 

/* size of initialized data */ 

/* size of uninitialized data */ 
/* size of symbol table */ 

/* entry point */ 

/* size of text relocation */ 

/* size of data relocation */ 


#define CHAPMAGIC 0420/* chap binary */ 

/* 

* Macros that take exec structures as arguments and tell whether 

* the file has a reasonable magic number or offsets to text I symbols I strings. 

*/ 

#define N_BADMAG(x) \ 

(((x).a_magic)!=OMAGIC && ((x).a_magic)!=NMAGIC && ((x).a_magic)!=ZMAGIC) 
#define N_TXTOFF(x)\ 

((x).a_magic=ZMAGIC ? PAGSIZ : sizeof (struct exec)) 

#define N_S YMOFF(x) \ 

(N_TXTOFF(x) + (x).a_text+(x).a_data + (x).a_trsize+(x).a_drsize) 

#define N_STROFF(x)\ 

(N_S YMOFF(x) + (x).a_syms) 

/* 

* Macros which take exec structures as arguments and tell where the 

* various pieces will be loaded. 

*/ 

#define N.TXTADDR(x) TXTRELOC 
#define N_DATADDR(x) \ 

(((x).a_magic=OMAGIC)? (N_TXTADDR(x)+(x).a_text) \ 

: (SEGSIZ+((N_TXTADDR(x)+(x).a_text-l) & 'SEGRND))) 

#define N_BSSADDR(x) (N_DATADDR(x)+(x).a_data) 


The chap.out file has five sections: a header, the program text and data, relocation information, a symbol 
table and a string table (in that order). The last three may be omitted if the program was loaded with the -s 
option of chid. 

In the header, the sizes of each section are given in bytes. The size of the header is not included in any of 
the other sizes. 
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When a chap.out file is downloaded, two logical segments are set up: the text segment and the data seg¬ 
ment (with uninitialized data, which starts off as all 0, following initialized data). The header is not loaded 
with the text segment The macros N_TXTADDR, N_DATADDR, and N_BSSADDR give the core 
addresses at which the text, data, and bss segments, respectively, will be loaded. 

After the header in the file, the text, data, text relocation data relocation, symbol table and string table fol¬ 
low in that order. The text begins just after the header. The N_TXTOFF macro returns this absolute file 
position when given the name of an exec structure as argument. The symbol table follows all this; its posi¬ 
tion is computed by the N_SYMOFF macro. Finally, the string table immediately follows the symbol table 
at a position easily gotten using N_STROFF. The first 4 bytes of the string table are not used for string 
storage, but rather contain the size of the string table; this size INCLUDES the 4 bytes. 

RELOCATION 

The value of a byte in the text or data that is not a portion of a reference to an undefined external symbol is 
exactly that value in memory when the file is executed. If a byte in the text or data involves a reference to 
an undefined external symbol, as indicated by the relocation information, then the value stored in the file is 
an offset from the associated external symbol. When the file is processed by the link editor, and the exter¬ 
nal symbol becomes defined, the value of the symbol is added to the bytes in the file. 

If relocation information is present, it amounts to eight bytes per relocatable datum as in the following 
structure: 

/* 

* Format of a relocation datum. 

*/ 

structrelocationjnfo { 

int r_address; /* address which is relocated */ 

unsigned r_symbolnum:24, /* local symbol ordinal */ 
r_pcrel: 1, /* always 0 */ 

r_length:2, /* always l=word */ 

r_extem: 1, /* does not include value of sym referenced */ 

:4; /* nothing, yet */ 

}; 

There is no relocation information if a_trsize+a_drsize==0. If r_extem is 0, then r_symbolnum is actually 
a n_type for the relocation (i.e., N_TEXT meaning relative to segment text origin.) 

SYMBOL TABLE 

The layout of a symbol table entry and the principal flags that distinguish symbol types are given in th< 
include file as follows: 

/* 

* Format of a symbol table entry. 

*/ 

struct nlist { 

union { 

char *n_name; /* for use when in-memory */ 
long n_strx; /* index into file string table */ 

} n_un; 

unsigned char n_type; /* type flag, i.e., N_TEXT etc; see below */ 

char n_other; 

short n_desc; /* see <stab.h> */ 

unsigned n_value; /* value of this symbol (or adb offset) */ 

}; 

#define n_hash n_desc /* used internally by Id */ 
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/* 

* Simple values for n_type. 

*/ 

#define N_UNDF 0x0 /* undefined */ 

#define N_ABS 0x2 /* absolute */ 

#define N_TEXT 0x4 /* text */ 

#define N_DATA 0x6 /* data */ 

#define NJBSS 0x8 /* bss */ 

#define N_QUAL 0x10 /* qualifier */ 

#define N_COMM 0x12 /* common (internal to chid) */ 

#define N_FN Ox If /* file name symbol */ 

#define N_PATCH 0x20 /* patch refs (internal to dynamic loader) */ 

#define N_EXT 01 /* external bit, or’ed in */ 

#define N_TYPE Oxle /* mask for all the type bits */ 

In the chap.out file, a symbol’s n_un.n_strx field gives an index into the string table. An n_strx value of 0 
indicates that no name is associated with a particular symbol table entry. The field n_un.n_name can refer 
to the symbol name only if the program sets this up using n_strx and appropriate data from the string table. 
Because of the union in the nlist declaration, it is impossible in C to statically initialize such a structure. 

If a symbol’s type is undefined external, and the value field is non-zero, the symbol is interpreted by the 
loader chid as the name of a common region whose size is indicated by the value of the symbol. 

SEE ALSO 

chas(l), chld(l), chnm(l) 
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NAME 

chapsym - Chap runtime symbol table 

SYNOPSIS 

#include <pixar/chapdiag.h> 

DESCRIPTION 

Each Chap on a host has a file containing information about code and data currently loaded in the machine 
This information, together with the symbols defined by the resident programs, constitutes the “runtime 
symbol table” for the Chap. 

The symbol table files’ header has the following definition: 

/* 

* This header is present at the 

* front of all symbol table files. 

*/ 

typedef struct symheader { 

long sh_magic; /* magic identifier */ 
u_short sh_syms; /* number of symbols */ 
u_short sh_refs; /* number of symbol references */ 
long sh_strsize; /* size of string table */ 
long sh_pad[8]; /* for future expansion */ 

} SymHeader; 

#define CHAPSYMMAGIC 0x030959 

#define S_BADMAG(h) ((h).sh_magic != CHAPSYMMAGIC) 

#define S_SYMOFF(h) (sizeof (SymHeader)) 

#define S_REFOFF(h) (S_SYMOFF(h) + (h).sh_syms * sizeof (LoadSym)) 

#define S_STROFF(h) (S_REFOFF(h) + (h).sh_refs * sizeof (SymRef)) 

Symbol table files have four sections: a header, the symbols, information about references to symbols, an 
a string table (in that order). 

In the header, the size of the symbol section is given in symbols, the size of the references section is give 
in references, and the size of the string table in bytes. The size of the header is not included in any of th 
other sizes. 

SYMBOLS 

The layout of a symbol entry closely follows that used in Chap object files, chap.out (5). In particular, tl 
principal flag values that distinguish symbol types must be identical. A symbol entry is given in the indue 
file as follows: 

/* 

* Beware, this structure must be compatible 

* with a struct nlist when on disk. 

*/ 

typedef union loadsym { 

struct ondisk { /* symbols as it’s stored on disk */ 

long lsu_strx; /* index into string table */ 

u_char lsu_type; 
u_char lsu_other; 
u_short lsu_desc; 
long lsu_value; 
u_short lsu_nrefs; 

long lsu_refx; /* index into reference table */ 
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lsu ondisk: 

/* segment information */ 

/* file name */ 

/* should always be N_FN */ 


/* base of code segment */ 

/* size of code segment */ 

/* base of data segment */ 

/* size of data segment */ 

/* reference count on file */ 

/* reserved for future expansion */ 

/* in-core version of symbol */ 

/* symbol name ff 
/* type a la struct nlist */ 

/* part of hash scheme */ 

/* symbol’s value */ 

/* # references to symbol */ 
union symref *lsu_refs; /* reference list */ 

} lsu_incore; 

} LoadSym; 

/* i’m so lazy... */ 

#define ls_strx lsu_ondisk.lsu_strx 
#define ls_refx lsu_ondisk.lsu_refx 

#define ls_name lsu_incore.lsu_name 
#define ls_type lsu_incore.lsu_type 
#define ls_value lsu_incore.lsu_value 
#define ls_nrefs lsu_incore.lsu_nrefs 
#define ls_hash lsu_incore.lsu_hash 
#define ls_refs lsu_incore.lsu_refs 

#define ls_tbase lsu_segsym.lsu_tbase 
#define ls_tsize lsu_segsym.lsu_tsize 
#define ls_dbase lsu_segsym.lsu_dbase 
#define ls_dsize lsu_segsym.lsu_dsize 

I* 

* Simple values for Is Jype. 

*/ 


#define N_UNDF 

0x0 

/* undefined */ 

#define N_ABS 

0x2 

/* absolute */ 

#define N_TEXT 

0x4 

/* text */ 

#define N_DATA 

0x6 

/* data */ 

#define N_BSS 

0x8 

/* bss */ 

#define N_QUAL 

0x10 

/* qualifier */ 

#define N_COMM 

0x12 

/* common (internal to chid) */ 

#define N_FN 

Ox If 

/* file name symbol */ 

#define N_PATCH 

0x20 

/* patch refs (internal to dynamic loader) */ 

#define N_EXT 

01 

/* external bit, or’ed in */ 


struct segsym { 

long lsu_strx; 
u_char lsu_type; 
u_char lsu_other; 
u_short lsu_hash; 
u_short lsu_tbase; 
u_short lsu_tsize; 
u_short lsu_dbase; 
u_short lsu_dsize; 
u_short lsu_refcnt; 
u_short lsu_pad; 

} lsu_segsym; 
struct incore { 

char *lsu_name; 
u„char lsu_type; 
u_char lsu_other; 
u_short lsu_hash; 
long lsu_value; 
u_short lsu_nrefs; 
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#define N_TYPE Oxle /* mask for all the type bits */ 

In the symbol table file, a symbol’s ls.strx field gives an index into the string table. An ls_strx value of 0 
indicates that no name is associated with a particular symbol table entry. The field ls_name refers to the 
symbol name only if the program sets this up using ls_strx and appropriate data from the string table. 

Similarly, a symbol’s ls_refx field gives an index into the reference table. The ls_nrefs field specifies the 
number of references associated with a symbol (see below). The field ls_refs can be used to refer to the 
symbol’s references only if the program sets this up using ls_refx and the appropriate data from the refer¬ 
ence table. 

The symbols section of the symbol table is segmented by file. The start of a file is delimited by a symbol 
with type N_FN. File name symbols have a special format symbol table entry containing a description of 
resources associated with the loaded file’s text and data segments (bss is converted to data at the time the 
file is relocated and loaded into a Chap). 

When a file is unloaded from a Chap but references still exist to symbols defined in the file, the file’s sym¬ 
bol table “segment” is preserved to allow entries to remain for the undefined symbols. By convention, 
segments of this type are assigned a file name of “*unloaded*”. All symbols in such a segment must be 
undefined. Unloaded segments are discarded from the symbol table when there are no longer references tc 
symbols contained in the segment. 

Finally, the in-core version of the symbol table may contain symbol entries with an ls_name entry of 0 
These entries are the result of symbols which have been deleted but can not be purged until the symbo 
table is written to disk and read back in again; they should be ignored. 

REFERENCE LISTS 

Each reference to an external symbol in a file processed by the dynamic loader results in a reference entr 
in the symbol table. References are tracked to allow segments of a program to be loaded piece-wise, wit! 
each new symbol’s definition/deletion resulting in validation/invalidation of references to the symbol. 

A reference list is a segmented linked-list of reference entries, each of which is described as: 

/* 

* Symbol references are kept in the 

* symbol table as a list of segments 

* (for dynamic expansion). 

*/ 


#define NREFSEG 8 

#define NREFMASK (NREFSEG-1) 

/* must be pow2 */ 

typedef union symref { 


struct { 


u_char sru_seg; 

/* segment */ 

u_char sru_pad; 
u_short sru_loc; 

/* location in spad/iram of reference */ 

) sru; 


union { 

union symref *sru_next; /* next block of references */ 

off_t sru_refx; 


} srun; 



) SymRef; 

#define sr_seg sru.sru_seg 
#define srjoc sru.sru_loc 
#define sr_pad sru.sru_pad 
#define sr_next srun.sru_next 
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#define sr_refx srun.sru_refx 

A symbol table entry points to a linked-list of reference blocks, each NREFSEG in length. For each refer¬ 
ence block, the last entry is always reserved for a pointer to another block of references. The reference 
itself specifies the segment, sr_seg, in which the reference resides and the location in scratchpad or instruc¬ 
tion memory (in words for scratchpad, instructions for instruction memory). 

SEE ALSO 

charm(l), ChapOpen(3H), ChapLoad(3H), chap.out(5) 

BUGS 

The segmented nature of the symbol table is unwieldy when it comes to deleting symbols and/or expanding 
segments. 
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NAME 

fbdefs, 

lfbdefs, 

fbpath, 

lfbpath - framebuffer description definitions 

SYNOPSIS 

setenv FBDEFS "fbdefifbdef:..." 
setenv LFBDEFS "Ifbdef: Ifbdef:..." 
setenv FBPATH "fbname:fbname:..." 
setenv LFBPATH "lfbnametlfbname:..." 

DESCRIPTION 

Physical frame buffer definitions (fbdefs ) and logical frame buffer definitions ( lfbdefs ) are definitions that 
assign names to rectangular areas of Pixar image memory. An fbdef describes a tile block of picture 
memory to be accessed by a particular chap. An Ifbdef describes a logical window mapping, or pixel win¬ 
dow , into a tile block. 

The environment variables FBPATH and LFBPATH are colon-separated lists of names of fbdefs and 
lfbdefs , respectively. These lists define reference orderings of physical and logical framebuffers. The first 
name in the FBPATH may be referred to as FBO, the second as FBI, etc. Names in the LFBPATH may be 
referenced as LFBO, LFB1, etc. The names defined in FBDEFS are appended to the FBPATH in the order 
in which they were defined, followed by a default fbdef. The LFBPATH is appended with the names in 
LFBDEFS, followed by the names in the FBPATH. 

An fbdef has the following syntax: 

name= [sizex sizey [starttile [device]]] 

where: 

name is the name of the framebuffer being defined 
sizex is the width in pixels of the framebuffer 
sizey is the height in pixels of the framebuffer 
starttile is the first tile to use for the tile block 

device is the name of the pixar/chap to use. Devices are referenced with the prefix pxr followed 
by a number N. N div 8 defines which pixar card cage to use. N mod 8 defines which 
chap to use. (ex: pxr 17 refers to chap 1 in card cage 2) 

Any optional arguments not defined are given the values of the default fbdef. The default fbdef is: pxiO = 
1024 4096 0 pxrO. 

An Ifbdef has the following syntax: 

[[name=] fbname] [xmin xmax ymin ymax] 

where: 

name is the name of the logical framebuffer being defined 

fbname is the name of the fbdef, the Ifbdef is being defined 

within. The fbname may be a previously defined fbdef or a device name such as pxr2. 
The latter type of name uses a default fbdef on the specified device. 

xminpcmax, is the window within the physical framebuffer to use as a logical framebuffer. If this is 
ymin,ymax, the only argument given for the Ifbdef, then fbdef FBO is used as the fbdef. 

SEE ALSO 

PW(3C), TB(3C), FbGetDef(3H) 
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NAME 

Diagnostic - Pixar system diagnostc check 

SYNOPSIS 

/usr/pixar/diag/bin/Diagnostic 

DESCRIPTION 

Diagnostic provides a menu driven interface to the PIXAR hardware test programs. The menu allows the 
operator to test major sections of the PIXAR Image Computer to the board level. Options also exist to 
report the PIXAR device configuration, and support the testing of multiple PIXAR Image Computers 
attached to a single host. 

The Diagnostic program attempts to determine the PIXAR Image Computer configuration, initializes all 
sections of the computer, and then tests the selected subsystems of the computer. Normally, a single pass 
test of the complete system (Selection 1) takes about 15 minutes. If failures occur, board level failure 
reports are printed to the operator’s terminal. 

FILES 

/usr/pixar/diag/bin/ * 

/usr/pixar/diag/ucode/* 

SEE ALSO 

chap(4) 
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NAME 

chconfig - Chap configuration tool 

SYNOPSIS 

chconfig [ -i iram-size ] [ -s spad-size ] [ -f fb-size ] [ -k stack-depth ] [ -c component-width ] [ -I 
imap-size ] [ -S smap-size ] [ -F fmap-size ] [ -a ] [ device ] 

DESCRIPTION 

chconfig is used to set or view the system’s idea of the hardware configuration of a Chap. This 
configuration information is maintained by the system and may be interrogated by programs so it may be 
written in a hardware-independent fashion, chconfig is normally run at boot time for each Chap on a sys¬ 
tem from the file “/etc/rc.local” with the -a flag. This causes chconfig to “autoconfigure” the Chap’s 
characteristics by running various tests intended to deduce the appropriate values for memory size, stack 
depth, etc. 

Other options to chconfig allow individual parameters to be set. If any of these parameters are set in con¬ 
junction with the -a flag, chconfig will use the specified parameters instead of the values it would normally 
use. The —i, -s, and —f options set the size of instruction RAM , scratchpad memory , and the associated 
framebuffer , respectively. Each size parameter is expressed in the units of the appropriate resource: 
instructions for instruction RAM, 4 word pixels for scratchpad memory, and 32x32 word tile blocks for 
framebuffer memory. The Chap’s stack depth and the framebuffer’s component width may be specified 
with the -k and -c flags (component width is specified in bits). 

In addition to the basic hardware characteristics, chconfig also defines the size of the resource allocation 
maps used by the system to keep track of memory allocation in each Chap and framebuffer. Three maps 
exist for each Chap-framebuffer pair: instruction RAM, scratchpad memory, and framebuffer memory. 
The size of each allocation map defines the number of hunks of non-contiguous free memory available at 
any one time. In normal operation, the maps are constantly being compacted, so this value normally 
reflects the maximum “fragmentation” allowed. If the map is too small to keep track of all the free 
memory for a particular resource, it discards part of the available memory. To reclaim the lost memory, 
the allocation maps must be reset. The -I, -S, and -F flags specify the size of the allocation maps for 
instruction RAM, scratchpad memory, and framebuffer memory, respectively. If the map sizes are not 
manually specified, chconfig allocates 250 entries to each map. 

The default device for chconfig is /dev/chapO; this may be changed by specifying a trailing device name on 
the command line. 

If chconfig is invoked without options, it prints the current configuration. 

NOTES 

In calculating the size of the framebuffer, the code loaded overwrites the first 32 pixels of each tile block. 

FILES 

/dev/chapO default Chap device 

/usr/pixar/chap/bin/config.ucode Chap code used for autoconfiguration 

SEE ALSO 

chap(4G) 
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NAME 

mctrl - set/clear options of a memory controller 

SYNOPSIS 

mctrl [ command ] ... 

DESCRIPTION 

mctrl is a simple program used to peek and poke registers on the memory controller. If no arguments are 
given, mctrl prints the contents of the control status register. Arguments are interpreted as commands and 
processed one at a time as follows: 

halt, -halt 

Set/clear the halt bit in the csr. 
aoen, -aoen 

Set/clear the address output enable bit in the csr. 
refen, -refen 

Set/clear the refresh enable bit in the csr. 
refinh, -refinh 

Clear/set the refresh enable bit in the csr. 

refx, -refx 

Set/clear the refresh X access bit in the csr. 

refy, -refy 

Set/clear the refresh Y access bit in the csr. 

refrd, -refrd 

Set/clear the refresh read bit in the csr. 
refwr, -refwr 

Clear/set the refresh read bit in the csr. 

refl6, -refl6 

Set/clear the refresh 16 bit in the csr. 
ref32, -ref32 

Clear/set the refresh 16 bit in the csr. 

The remaining arguments are treated either as peek or poke requests for memory controller registers, or as 
a bit definition for a register (where appropriate). A peek is specified by a register name alone; a poke by a 
register name followed by a hexadecimal value. To use a bit definition, the register name must precede the 


name of the bit (see the 

usage message for more information). The register names are: 

csr 

control status register 

mips 

MIPS meter register 

step 

single step register 

req 

iobus request register 

addrO 

iobus address (low) register 

addrl 

iobus address (high) register 

addr2 

iobus device select register 

addrjoad 

iobus readback load register 

req_aO 

iobus grant pal (low) register 

req_al 

iobus grant pal (high) register 

req_a2 

iobus grant enable register 

resO 

reservation table 0 register 

resl 

reservation table 1 register 

res2 

reservation table 2 register 

res3 

reservation table 3 register 

vbusO 

Vbus sequencer 0 register 
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vbusO Vbus sequencer 1 register 

pbusO Pbus sequencer 0 register 

pbusO Pbus sequencer 1 register 

memO memory address 0 register 

meml memory address 1 register 

mem2 memory address 2 register 

mctrl catches faults generated by peeks and pokes on the Sysbus and prints the message “Bus error”. 

SEE ALSO 

dumi(4), mctrl(4) 
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1. Overview 

(1) This document describes the installation of PIXAR 
software on SUN Unix version 3.2. Refer to the SUN 
manuals entitled "Installing UNIX" and "Release 3.2 
Manual", for details of installing Unix on a new system 
or upgrading an old system. 

(2) If you are upgrading an old system, make a set of level 
zero dump tapes of all filesystems before beginning the 
install. These tapes will provide a safety net in the 
event of a serious problem. 

(3) Where additional detail is desired additional documen¬ 
tation for the non-PIXAR postion of the install is 
available in the SUN documents entitled "System 
Administration", and "Writing Device Drivers". The 
second document will be especially valuable if non¬ 
standard device configurations are required. 

(4) SUN release 3.2 is being included with PIXAR software 
release 1.2. New systems are shipped with the normal 
set of SUN manuals, older systems are shipped with the 
SUN Release 3.2 manual. 

(5) PIXAR recommendeds that installations running older SUN 
releases convert immediately to 3.2, before installing 
PIXAR release 1.2. However, should you temporarily 
decide to install PIXAR release 1.2 first and convert 
to SUN 3.2 at a later date, see the cautionary notes at 
the end of this document under "Older SUN Releases". 

2. Setup Prerequisites 

(1) The Sun system must report 

Self Test Completed successfully. 

when system power is first turned on and the monitor 
quick self-test is run. 

(2) The disk formatting operation must have been completed 
correctly with no uncorrectable errors. If the disk is 
already formatted and is not to be re-formatted, the 
disk test must be run. If the system is equipped with 
a Xylogics 450 or Xylogics 451 disk controller, the 
dmatest must be run for 10 minutes. No failures should 
be detected. 

The diag program is booted from the monitor using the 
command line: 


> b stand/diag 
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Refer to DIAG(8S) in the Maintenance Commands section 
of the System Internals Manual for the Sun UNIX System. 

(3) The disk should be built up with the current version of 
Sun Release 3.2 software, from the Sun Operating System 
installation tapes. See SUN's document entitled 
"Installing Unix". 

(4) The system should be equipped with a 1/4" streaming 
cartridge tape drive, or have network access to a sys¬ 
tem with such a tape drive. 

3. General Description 

The software release installation procedure consists of 
three general parts. 

(1) Software loading from tapes onto the disk. 

(2) Software installation. 

(3) Software turn-on and operational checks. 

4. Software Loading 

The PIXAR Software Release 1.2 is supplied on several 
magnetic tapes. The following description of the first two 
tapes is subject to change without notice. Tape 1 contains 
the Chap and host libraries, host utility and applications 
programs, manual pages, and the tutorial programs. This 
tape requires at least 13 Megabytes of disk space. Tape 2 
contains the demonstration programs, and requires 11 Mega¬ 
bytes of disk space. 

4.1. Cartridge Tape Drive 

If the system is equipped with a cartridge tape drive, 
software can be loaded onto disk as follows: 

(1) Put tape 1 of 2 into the tape drive. 

(2) Log in on the Sun Workstation as root. 

(3) At the UNIX command prompt, '# ', type the following 
command line: 

tar pxvfb /dev/rstO 256 


(4) Once the tape has been read in, remove the tape from 
the tape drive. 
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(5) Put tape 2 of 2 into the tape drive. 

(6) At the UNIX command prompt, '# ', type the following 
command line: 

tar pxvfb /dev/rstO 256 


(7) Once the tape has been read in, remove the tape from 
the tape drive. 

If software is to be loaded over the net, using a 

remote system's tape drive, proceed as follows: 

(1) Put tape 1 of 2 into the tape drive of the remote sys¬ 
tem. This system will be referred to as host 'remote' 
throughout this procedure. 

(2) Log in on the Sun Workstation on which the software is 
to be installed as root. 

(3) At the UNIX command prompt, '# ', type the following 
command line: 

rsh remote dd if=/dev/rstO bs=128k | tar pxvfb - 256 

This command line tells the system named 'remote' to 
read the tape in 128 Kbyte blocks, and sent the output 
over the net to the 'tar' program. The '-' argument to 
tar tells tar to read it's input from the pipe instead 
of a tape. 

(4) Once the tape has been read in, remove the tape from 
the tape drive. 

(5) Put tape 2 of 2 into the tape drive of the remote sys¬ 
tem. 

(6) At the UNIX command prompt, '# ', type the following 
command line: 

rsh remote dd if=/dev/rstO bs=128k | tar pxvfb - 256 


(7) Once the tape has been read in, remove the tape from 
the tape drive. 

4.2. 1/2 Inch Magtape Drives 

The 1/2 " tapes supplied are recorded at 1600 BPI using 
the 'tar' program and the raw magtape interface. The tape 
blocking factor is 20, resulting in 10 Kilobyte tape blocks. 
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If the system is equipped with a 1/2 ” magtape drive, 
software can be loaded onto disk as follows: 

(1) Mount tape 1 of 2 on the tape drive. 

(2) Log in on the Sun Workstation as root. 

(3) At the UNIX command prompt, '# ', type the following 
command line: 

tar pxvfb /dev/rmt8 20 


(4) Once the tape has been read in, rewind and remove the 
tape from the tape drive. 

(5) Put tape 2 of 2 into the tape drive. 

(6) At the UNIX command prompt, '# ', type the following 
command line: 

tar pxvfb /dev/rmt8 20 


(7) Once the tape has been read in, rewind and remove the 
tape from the tape drive. 

If software is to be loaded over the net, using a 

remote system's tape drive, proceed as follows: 

(1) Mount tape 1 of 2 on the tape drive of the remote sys¬ 
tem. This system will be referred to as host 'remote' 
throughout this procedure. 

(2) Log in on the Sun Workstation on which the software is 
to be installed as root. 

(3) At the UNIX command prompt, '# ', type the following 
command line: 

rsh remote dd if=/dev/rmt8 bs=10k | tar pxvfb - 20 

This command line tells the system named 'remote' to 
read the tape in 10 Kbyte blocks, and sent the output 
over the net to the 'tar' program. The '-' argument to 
tar tells tar to read it's input from the pipe instead 
of a tape. 

(4) Once the tape has been read in, rewind and remove the 
tape from the tape drive. 

(5) Mount tape 2 of 2 on the tape drive of the remote sys¬ 
tem. 
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(6) At the UNIX command prompt, '# ', type the following 
command line: 

rsh remote dd if=/dev/rmt8 bs=10k | tar pxvfb - 20 


(7) Once the tape has been read in, rewind and remove the 
tape from the tape drive. 

5. Software Installation 

Now that the software has been loaded onto the Sun 
Workstation disk, it must be set up for use. This setup 
consists of making a backup of the PIXAR software, instal¬ 
ling a kernel with the PIXAR device drivers, setting up the 
device files, and adding a few commands to the /etc/rc.local 
file to initialize the PIXAR computer cage when the host is 
started. 

The general installation procedure is as follows: 

(1) Make a backup tape using the customer's tape drive, as 
in the section "Make a Backup". 

(2) Determine if the default PIXAR UNIX kernel can be used. 
If the customer does not currently have a customized 
UNIX kernel, the default PIXAR UNIX kernel can be used. 
Proceed as in the section "Default Installation". 

(3) If a custom kernel is needed, proceed as in the section 
"Custom Kernel Installation". If the customer is 
adding his own device drivers to the SUN UNIX kernel, a 
custom kernel must be made. 

(4) If more than one DUMI interface and PIXAR Image Com¬ 
puter are to be connected to the host, do the default 
or custom installation as appropriate, and then add the 
additional device entries as described in the section 
"PIXAR Device Installation". 

(5) If multiple Chap boards or video boards are installed 
in the customer's PIXAR Image Computer, do the default 
or custom installation as appropriate, and then add the 
additional device entries as described in the section 
"PIXAR Device Installation". 

5.1. Make a Backup 

Make a backup tape using the customer's Sun Workstation 
tape drive. Using the customer's tape drive minimizes the 
chance of making an unreadable backup tape due to mechanical 
and electrical variations from one tape drive to another. 
The backup operation will take about 30 minutes. 
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The customer may also want to perform an incremental 
dump of the /usr filesystem at this time. 

5.1.1. Cartridge Tape Drives 

If the system is equipped with a cartridge tape drive, 
software can be backed up to tape as follows: 

(1) Put the tape into the tape drive. Note that the tape 
should be 450 feet or longer and rated at 10,000 FTPI 
(8000 BPI). The backup will require about 24 Megabytes 
of tape storage. 

(2) Log in on the Sun Workstation as root. 

(3) At the UNIX command prompt, '# ', type the following 
command line: 

tar crvfb /dev/rstO 256 /usr/pixar 

This tape may be used to load the PIXAR software on to 
the system at a later date. 

If software is to be backed up over the net, using a 
remote system's tape drive, proceed as follows: 

(1) Put the tape into the tape drive of the remote system. 

This system will be referred to as host 'remote' 
throughout this procedure. 

(2) Log in on the Sun Workstation on which the software is 
to be backed up as root. 

(3) At the UNIX command prompt, '# ', type the following 
command line: 

tar crfb - 256 /usr/pixar | rsh remote dd of=/dev/rst0 bs=128k 


5.1.2. 1/2 Inch Magtape Drives 

If the system is equipped with a 1/2 " magtape drive, 
software can be backed up to tape as follows: 

(1) Mount a blank tape on the tape drive. The tape will be 
written at 1600 BPI with a blocking factor of 20. 
About 24 Megabytes will be written to the tape. A 2400 
foot tape reel is recommended. 

(2) Log in on the Sun Workstation as root. 

(3) At the UNIX command prompt, '# ', type the following 
command line: 
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tar crvfb /dev/rmt8 20 /usr/pixar 

This tape may be used to load the PIXAR software on to 
the system at a later date. 

If software is to be backed up over the net, using a 
remote system's tape drive, proceed as follows: 

(1) Mount the tape on the tape drive of the remote system. 

This system will be referred to as host 'remote' 
throughout this procedure. 

(2) Log in on the Sun Workstation on which the software is 
to be backed up as root. 

(3) At the UNIX command prompt, '# ', type the following 
command line: 

tar crfb - 20 /usr/pixar | rsh remote dd of=/dev/rmt8 bs=10k 


5.2. Default Installation 

A default system may be configured by running the shell 
script 


/usr/pixar/sys/DEFAULT 

The default system consists of a Sun 3 computer, one DUMI 
interface, and one PIXAR Image Computer. A modem may be 
attached to Serial Port B on the Sun 3 computer. 

The default device configuration supports up to three 
Chaps and two video boards in the PIXAR card cage. Refer to 
"PIXAR Device Installation" for information on adding addi¬ 
tional device entries. 

5.3. Custom Kernel Installation 

A custom kernel is only needed if the customer is not 
using the Sun 3 GENERIC kernel. The default PIXAR kernel at 
/usr/pixar/sys/vmunix is the Sun 3 GENERIC kernel with the 
PIXAR device driver added. This default PIXAR kernel is 
capable of supporting multiple PIXAR Image Computers and 
DUMI interface boards. Refer to "PIXAR Device Installation" 
for details on adding additional device entries. 

Follow these steps to build a custom UNIX kernel for a 
Sun 3 Workstation. Please be careful. 

(1} cd /sys/OBJ 
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(2) Copy the PIXAR device driver object module to /sys/OBJ: 
cp /usr/pixar/sys/pixar.obj /sys/OBJ/pixar.o 


(3) cd ../conf 

(4) Edit "files.sun3" and append the following line to the 
file: 

pixardev/pixar.c optional dumi device-driver 

The file doesn't actually exist, but this makes config 
write a makefile that uses /sys/OBJ/pixar.o. 

(5) List the files in this directory and look at the vari¬ 
ous configurations files (the ones in all capital 
letters) . Decide (or ask) if the customer has already 
customized a configuration. If not, "cp GENERIC PIXAR" 
and "mkdir ../PIXAR". Now edit the appropriate confi¬ 
guration file (PIXAR or the customer's file) and append 
this line: 

For Multibus Suns (Sun 2): 

device dumiO at mbO csr OxaOOOO priority 2 


For VME Suns (Sun 3): 

device dumiO at vme24dl6 ? csr OxeaOOOO priority 2 vector dumiint 


(6) Configure the custom kernel by typing the command: 

/etc/config PIXAR 

If using a configuration file other than PIXAR, use 
that file as the argument to config. 

(7) cd ../sun 

(8) Edit "conf.c" and add the following lines just before 
the line that says 

extern int ttselect(), seltrue(); 

This code is duplicated in /usr/pixar/sys/pixar_conf.c 
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#include "dumi.h" 

#if NDUMI > 0 

int dumiopen() , dumiclose() , dumiioctl() , dumimmap(); 

#else 

#define dumiopen nodev 

#define dumiclose nodev 

#define dumiioctl nodev 

fdefine dumimmap nodev 

#endif 

Add the following lines after a similar set of lines 
that define device number 34: 

{ 

dumiopen, dumiclose, nodev, nodev, /*35 

dumiioctl, nodev, nulldev, 0, 

seltrue, dumimmap, 

}, 


CAUTION 

These lines are position dependent and must really come 
after the 34th entry in the file. The numbered comment 
(e.g. "/*35*/") serves as a reminder of this. If the 
customer already has a device at position 35 place the 
lines for the dumi at the end of the list and change 
the comment to be the next higher number. Remember 
this number, it will be needed as a parameter to 
/usr/pixar/sys/MAKEDEV when making the devices in 
"/dev" later on. 

(9) Move to the configuration directory that was set up 
earlier. 

cd ../PIXAR 


(10) Unfortunately, some hand copying of include files is 
also required. First, copy all the files from 
/usr/pixar/include/pixardev into /sys/pixardev. This 
provides the bulk of the include files needed for the 
kernel. In addition, create /usr/include/pixar as a 
symbolic link to /usr/pixar/include/pixar. The reason 
for this is buried in history, and later releases will 
not require this symbolic link. 

(11) Type the command 'make'. The kernel will now be com¬ 
piled and loaded. 

(12) Make the devices in /dev by using the following com¬ 
mands. If the major device number is to be 35, just 
type: 
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/usr/pixar/sys/MAKEDEV 


If the major device number is something other than 35, 
just type: 


/usr/pixar/sys/MAKEDEV XXX 


Where XXX is the desired major device number. 

(13) Install the new kernel in the root directory, by enter¬ 
ing the following commands. If the customer's confi¬ 
guration file name is something other than PIXAR, use 
that name instead of PIXAR as the /sys subdirectory. 

cd / 

mv vmunix vmunix.works 
mv /sys/PIXAR/vmunix / 


(14) To initialize the PIXAR system automatically on a 
reboot, add the following two lines to /etc/rc.local: 

/usr/pixar/host/bin/chconfig -a -k 32 /dev/chapO 
/usr/pixar/host/bin/video -file /dev/videoO -version 1 

These two lines are also found in 

/usr/pixar/sys/rc.local for your convenience. 

(15) "fastboot" the system. If all goes well you should see 
the following: 

Multibus systems: 
dumiO at mbmem aOOOO pri 2 
chapO on dumiO at a0800 
videoO on dumiO at a4800 
mctrl on dumiO at a6800 
dw on dumiO at a8000 

VME systems: 

dumiO at vme24dl6 eaOOOO vec 0xc8 
chapO on dumiO at ffea0800 
videoO on dumiO at ffea4800 
mctrl on dumiO at ffea6800 

If the PIXAR isn't turned on you won't see the entries 
for chapO and videoO. 

(16) If the new kernel fails to boot, get back to the moni¬ 
tor, using the <PF1><A> key combination. Boot the good 
kernel that you saved as /vmunix.works from the monitor 
prompt. 
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> b /vmunix.works 

Carefully review the configuration changes that were 
made. Make sure that no errors are reported when con¬ 
figuring or making the new kernel, and try again. 

5.4. PIXAR Device Installation 

The PIXAR device driver supports multiple PIXAR Image 
Computers, as well as multiple Chap and video boards in each 
computer. To use all of this hardware, device entries must 
be made in the /dev directory. For a system with a single 
PIXAR Image Computer, these /dev/entries are created by run¬ 
ning /usr/pixar/sys/MAKEDEV. If your system has more than 
one PIXAR Image Computer, read the following paragraphs, 
which explain the PIXAR naming conventions needed for using 


1 

/dev/dumiO 

0 

0 

DUMI Interface Board | 

/dev/chapO 

0 

1 

Chap 0 | 

/dev/chapl 

0 

2 

Chap 1 | 

/dev/chap2 

0 

3 

Chap 2 | 

/dev/videoO 

0 

9 

Video Board 0 | 

/dev/videol 

0 

10 

Video Board 1 | 

/dev/mctrlO 

0 

13 

Memory Controller | 

/dev/diskwO 

0 

15 

Disk Window | 

/dev/dumi8 

1 

16 

1 

DUMI Interface Board | 

/dev/chap8 

1 

17 

Chap 0 | 

/dev/chap9 

1 

18 

Chap 1 | 

/dev/chaplO 

1 

19 

Chap 2 | 

/dev/video8 

1 

25 

Video Board 0 | 

/dev/video9 

1 

26 

Video Board 1 | 

/dev/mctrl8 

1 

29 

Memory Controller I 

/dev/diskw8 

1 

31 

Disk Window | 

/dev/dumil6 

2 

32 

1 

DUMI Interface Board | 

/dev/chapl6 

2 

33 

Chap 0 | 

/dev/chapl7 

2 

34 

Chap 1 | 

/dev/chapl8 

2 

35 

Chap 2 | 

/dev/videol6 

2 

41 

Video Board 0 | 

/dev/videol7 

2 

42 

Video Board 1 I 

/dev/mctrll6 

2 

45 

Memory Controller | 

/dev/diskwl6 

2 

47 

Disk Window | 

1 


Table 1. Device naming conventions. 
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the the UNIX mknod command. 

A device naming convention exists which should be fol¬ 
lowed closely, in order to avoid problems with future equip¬ 
ment and support. The device name consists of a terse 
descriptive name followed by a number. 

The number following the device name indicates which 
PIXAR Image Computer contains that device. Blocks of 8 
numbers are assigned to each computer. Thus, on a host sys¬ 
tem with multiple PIXAR Image Computers, /dev/chapO refers 
to the first Chap in the first PIXAR, and /dev/chap8 refers 
to the first Chap in the second PIXAR. 

The minor device number is used as an argument to the 
'mknod' UNIX command. This number identifies the device to 
the operating system. Note that the shell script 
/usr/pixar/sys/MAKEDEV will set up entries for one PIXAR 
Image Computer with one Chap and one Video Board. All other 
devices must be made using 'mknod'. 

Mknod makes a special file. The first argument is the 
name of the entry. The second argument is 'c' for all PIXAR 
devices. The last two arguments specify the major device 
type (usually 35) and the minor device. 

/etc/mknod name c major minor 

If a custom kernel was made, use the major device number 
that the PIXAR device driver was placed at. Refer to Table 
1 for the minor device number. 

6. Software Turn-On 

Once the software has been installed in a system, the 
complete package should be verified to be operational. This 
verification consists of running the diagnostics and the 
demo programs on a system which has just been powered up. 

(1) The system should initially be shut down, with no power 
applied. 

(2) Apply power to the Sun Workstation and the PIXAR Image 
Computer. Start up the Sun Workstation running UNIX in 
multi-user mode. 

(3) Log in to the Sun Workstation. 

(4) Type the command: 

/usr/pixar/host/bin/pixinit 

Note that on a multi-PIXAR system, the commands in the 
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pixinit shell script will be run individually for each 
PIXAR attached to the host system. 

(5) Type the command: 

/usr/pixar/diag/bin/Diagnostic 


(6) Select Option 1 from the menu, and press <RETURN>. The 
diagnostics should run without any errors and return to 
the menu. 

(7) Type the following commands: 

cd /usr/pixar/demo 
Demo 

This runs the Demo program. The Demo program will not 
work under suntools. 

(8) Run each of the demo programs. No error messages should 
occur. 

Note that the message 'silo overflow' may appear when 
starting the FFT Demo. This is harmless, and is usually 
due to mouse motion having occurred before a program 
was ready to use the mouse. Exit the FFT demo by 
clicking the left and right mouse buttons twice. 

(9) That's it! If no problems have occurred, the software 
installation is done. 

7. Installation Notes 

This section contains assorted installation notes on 
how to take care of software problems that may occur in set¬ 
ting up the system at a customer's site. 

7.1. Ethernet On/Off 

If no Ethernet service is to be supplied at the custo¬ 
mer site, the Sun Workstation should be told that the net¬ 
work is unavailable. If this is not done, cryptic error 
messages about device 'ieO' will keep appearing on the con¬ 
sole. 


Add the following command line to the file 
/etc/rc.local: 

/etc/ifconfig ieO down 

This will tell the Sun Operating System that the network is 
not to be used, every time the system is rebooted. Refer to 
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the Sun Programmer's Manual IFC0NFIG(8C) for details. 

7.2. Second Ethernet Controller 

SUN VME systems with a second ethernet controller will 
have an address overlap problem with the dumi hardware 
registers. This requires a different switch setting for the 
VME adaptor and a change to the config file. Contact PIXAR 
customer support if your system has a second ethernet con¬ 
troller . 

7.3. Modem Support 

A shell script is supplied to turn on hardware carrier 
control for a Sun 3 Serial Port B with attached Hayes modem. 
This allows automatic dialout using a Hayes modem and the 
'tip' program, and supports the Hayes auto-answer function 
for dialup lines. 

The DEFAULT shell script automatically sets up modem 
operation and related support for tip and uucp. Manual 
installation is described below. 

7.3.1. Software Installation 

If the PIXAR software is installed without using the 
DEFAULT shell script, the modem software setup may be done 
as follows: 

(1) The PIXAR Release 1.2 software must be loaded and 
installed before proceeding. 

(2) Log in as root. Change directories to /usr/pixar/sys 

# cd /usr/pixar/sys 


(3) Type the command 'uu_install'. 
# uu install 


(4) Type the command 'modem on'. 
# modem on 


(5) Re-boot the system, using 'fastboot' 

The 'uu_install' shell script has installed UUCP sup¬ 
port, and a working /etc/remote file. The old /etc/remote 
file is saved at '/etc/remote.old'. The 'modem' script has 
patched /vmunix to enable modem control on Serial Port B. 
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8. Hardware Installation 

Hardware installation consists of connecting the modem 
to Serial Port B, and setting up the modem switches. 

(1) Plug the RS-232C cable into Serial Port B on the back 
of the Sun CPU board. 

(2) Connect the other end of the cable to the back of the 
Hayes Smartmodem 1200. 

(3) Remove the end cap from the front of the modem. 

(4) Check the switch settings and set as follows: 


1 1 1 - ■ II 


1 

| Down 

I Software DTR | | 


2 

| Down 

| Numeric result codes. || 


3 

| Down 

1 Result codes displayed. j | 


4 

| Down 

1 Do not echo commands. || 


5 

1 Up 

1 Auto-answer on. || 


6 

1 Up 

1 Automatic Carrier Detect. !i 


7 

1 Up 

I Setting for RJ11 single-line phone. || 


7 

I Down 

1 Setting for RJ12 or RJ13 multi-line phone.|| 


8 

| Down 

I Enable Command Recognition. || 


9 

1 Up 

1 Bell-212 Compatibility. j | 


10 

1 Up 

j Bell-212 Compatibility. || 


(5) Plug in the modem and turn on power. 

(6) Test the system by using 'tip' to dial a local computer 
system. The /etc/remote file is configured to dial 
PIXAR automatically, as follows: 

% tip Pixar 
% tip pixar 

8.1. Older SUN Releases 

SUN release 3.2 is included with PIXAR version 1.2 and 
PIXAR recommends that you install SUN 3.2 prior to instal¬ 
ling .PIXAR 1.2. If this is not possible, use the files with 
suffix "_3.0” in /usr/pixar/sys in place of the normal ones. 
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For PIXAR device driver: 

./DEFAULT_3.0 
./MAKEDEV_3.0 
./pixar_conf.c_3.0 
./rc.local_3.0 
./vmunix_3.0 
./tablet_3.0 

For PIXAR tablet line discipline: 

./tablet/vmunix_3.0 
./tablet/tty_conf.o_3.0 
./tablet/tty_tb.o_3.0 
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1 23:29 1986 /usr/pixar/sys/tablet/tty_conf.o_3 
1 23:29 1986 /usr/pixar/sys/tablet/tty__tb .o_3.0 
4 17:09 1986 /usr/pixar/sys/tablet/test/ 

1 23:29 1986 /usr/pixar/sys/tablet/test/tablet 
1 23:29 1986 /usr/pixar/sys/tablet/test/tablet. 
1 23:29 1986 /usr/pixar/sys/tablet/test/tb 
1 23:29 1986 /usr/pixar/sys/tablet/test/tb.c 
1 23:29 1986 /usr/pixar/sys/tablet/test/README 
1 23:29 1986 /usr/pixar/sys/vmunix_3.0 
3 12:34 1986 /usr/pixar/sys/modem 

3 12:41 1986 /usr/pixar/sys/uu_install 

4 17:08 1986 /usr/pixar/man/ 

4 17:07 1986 /usr/pixar/man/cat7/ 

4 17:07 1986 /usr/pixar/man/catl/ 

4 17:07 1986 /usr/pixar/man/cat3/ 

4 17:07 1986 /usr/pixar/man/cat4/ 

4 17:07 1986 /usr/pixar/man/cat5/ 

4 17:07 1986 /usr/pixar/man/cat8/ 

4 17:07 1986 /usr/pixar/man/manl/ 

3 19:09 1986 /usr/pixar/man/manl/intro.1 
3 19:09 1986 /usr/pixar/man/manl/charm. 1 
3 19:09 1986 /usr/pixar/man/manl/chas.1 
3 19:09 1986 /usr/pixar/man/manl/chc.1 
3 19:09 1986 /usr/pixar/man/manl/chcmp.1 
3 19:09 1986 /usr/pixar/man/manl/chd.1 
3 19:09 1986 /usr/pixar/man/manl/chld.1 
3 19:09 1986 /usr/pixar/man/manl/chload.1 
3 19:09 1986 /usr/pixar/man/manl/chmap.1 
3 19:09 1986 /usr/pixar/man/manl/chnm.1 
3 19:09 1986 /usr/pixar/man/manl/chranlib.1 
3 19:09 1986 /usr/pixar/man/manl/chsize.1 
3 19:09 1986 /usr/pixar/man/manl/dumi.1 
3 19:08 1986 /usr/pixar/man/manl/blur.1 
3 19:08 1986 /usr/pixar/man/manl/cbars.1 
3 19:09 1986 /usr/pixar/man/manl/cha.1 
3 19:09 1986 /usr/pixar/man/manl/clamp.1 
3 19:09 1986 /usr/pixar/man/manl/clr.1 
3 19:09 1986 /usr/pixar/man/manl/conv.1 
3 19:09 1986 /usr/pixar/man/manl/copy.1 
3 19:09 1986 /usr/pixar/man/manl/crc.1 
3 19:09 1986 /usr/pixar/man/manl/gamma.1 
3 19:09 1986 /usr/pixar/man/manl/gt.1 
3 19:09 1986 /usr/pixar/man/manl/gtinfo.1 
3 19:09 1986 /usr/pixar/man/manl/guide.1 
3 19:09 1986 /usr/pixar/man/manl/hg.1 
3 19:09 1986 /usr/pixar/man/manl/loop.1 
3 19:09 1986 /usr/pixar/man/manl/merge.1 
3 19:09 1986 /usr/pixar/man/manl/perm.1 
3 19:09 1986 /usr/pixar/man/manl/pixinit.1 
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2587 Dec 3 19:09 1986 /usr/pixar/man/manl/ramp.1 
3040 Dec 3 19:09 1986 /usr/pixar/man/manl/resize.1 
3031 Nov 28 13:29 1986 /usr/pixar/man/manl/rotate.1 
2705 Dec 3 19:09 1986 /usr/pixar/man/manl/scale.1 
2097 Dec 3 19:09 1986 /usr/pixar/man/manl/see.1 
2724 Dec 3 19:09 1986 /usr/pixar/man/manl/sv.1 
2764 Dec 3 19:09 1986 /usr/pixar/man/manl/tool.1 
2174 Dec 3 19:09 1986 /usr/pixar/man/manl/video.1 
0 Dec 4 17:08 1986 /usr/pixar/man/man3/ 

265 Dec 3 19:53 1986 /usr/pixar/man/man3/docu 
237 Dec 3 19:53 1986 /usr/pixar/man/man3/errors 
6245 Dec 3 20:01 1986 /usr/pixar/man/man3/ChadAlloc.3 
1615 Dec 3 19:56 1986 /usr/pixar/man/man3/ChadBegin.3 
3580 Nov 28 13:31 1986 /usr/pixar/man/man3/linetest.c 
4329 Dec 3 20:02 1986 /usr/pixar/man/man3/ChadWrite.3 
4232 Dec 3 19:11 1986 /usr/pixar/man/man3/intro.3c 
1089 Dec 3 19:11 1986 /usr/pixar/man/man3/SSClamp.3c 
2315 Dec 3 19:11 1986 /usr/pixar/man/man3/XYZ2rgb.3c 
1278 Dec 3 19:11 1986 /usr/pixar/man/man3/libcolor.3c 
2364 Dec 3 19:12 1986 /usr/pixar/man/man3/rgb2XYZ.3c 
2561 Dec 3 19:12 1986 /usr/pixar/man/man3/rgb2xyY.3c 
1516 Dec 3 19:12 1986 /usr/pixar/man/man3/libpg.3c 
1690 Dec 3 19:12 1986 /usr/pixar/man/man3/mman.3c 
3208 Dec 3 19:12 1986 /usr/pixar/man/man3/stack.3c 
2039 Dec 3 19:09 1986 /usr/pixar/man/man3/C33.3c 
2008 Dec 3 19:09 1986 /usr/pixar/man/man3/C33s.3c 
2086 Dec 3 19:09 1986 /usr/pixar/man/man3/C55s.3c 
1514 Dec 3 19:10 1986 /usr/pixar/man/man3/PWArithmetic.3c 
1546 Dec 3 19:10 1986 /usr/pixar/man/man3/PWBBox.3c 
1899 Dec 3 19:10 1986 /usr/pixar/man/man3/PWBoxFilter.3c 
2032 Dec 3 19:10 1986 /usr/pixar/man/man3/PWConv.3c 
993 Dec 3 19:10 1986 /usr/pixar/man/man3/PWCrc.3c 
1626 Dec 3 19:10 1986 /usr/pixar/man/man3/PWHistogram.3c 
1352 Dec 3 19:10 1986 /usr/pixar/man/man3/PWMap.3c 
1176 Dec 3 19:10 1986 /usr/pixar/man/man3/PWRange.3c 
1461 Dec 3 19:10 1986 /usr/pixar/man/man3/PWc33.3c 
1444 Dec 3 19:10 1986 /usr/pixar/man/man3/PWc33s.3c 
1623 Dec 3 19:11 1986 /usr/pixar/man/man3/SSArithmetic.3c 
1639 Dec 3 19:11 1986 /usr/pixar/man/man3/SSBoxFilter.3c 
2197 Dec 3 19:11 1986 /usr/pixar/man/man3/SSConv.3c 
1168 Dec 3 19:11 1986 /usr/pixar/man/man3/SSCrc.3c 
1198 Dec 3 19:11 1986 /usr/pixar/man/man3/SSRange.3c 
1658 Dec 3 19:11 1986 /usr/pixar/man/man3/dhg.3c 
4104 Dec 3 19:12 1986 /usr/pixar/man/man3/libpip.3c 
3666 Dec 3 19:12 1986 /usr/pixar/man/man3/libpm.3c 
2656 Dec 3 19:12 1986 /usr/pixar/man/man3/matrix.3c 
1739 Dec 3 19:12 1986 /usr/pixar/man/man3/reciprocal.3c 
2297 Dec 3 19:12 1986 /usr/pixar/man/man3/recsqrt.3c 
1491 Dec 3 19:12 1986 /usr/pixar/man/man3/rrand.3c 
2274 Dec 3 19:12 1986 /usr/pixar/man/man3/sqrt.3c 
6519 Dec 3 19:12 1986 /usr/pixar/man/man3/xp.3c 
3340 Dec 3 19:09 1986 /usr/pixar/man/man3/CFCopy.3c 
1861 Dec 3 19:09 1986 /usr/pixar/man/man3/CICopy.3c 
1244 Dec 3 19:09 1986 /usr/pixar/man/man3/CRCopy.3c 
4624 Dec 3 19:10 1986 /usr/pixar/man/man3/FCCopy.3c 
4642 Dec 3 19:10 1986 /usr/pixar/man/man3/FICopy.3c 
2831 Dec 3 19:10 1986 /usr/pixar/man/man3/FRGBACopy.3c 
2415 Dec 3 19:10 1986 /usr/pixar/man/man3/FSCopy.3c 
1446 Dec 3 19:10 1986 /usr/pixar/man/man3/FYCopy.3c 
3226 Dec 3 19:10 1986 /usr/pixar/man/man3/IFCopy.3c 
3736 Dec 3 19:10 1986 /usr/pixar/man/man3/PW.3c 
1039 Dec 3 19:10 1986 /usr/pixar/man/man3/PW4Map.3c 
1196 Dec 3 19:10 1986 /usr/pixar/man/man3/PWAxb.3c 
1788 Dec 3 19:10 1986 /usr/pixar/man/man3/PWCha.3c 
1107 Dec 3 19:10 1986 /usr/pixar/man/man3/PWClamp.3c 
954 Dec 3 19:10 1986 /usr/pixar/man/man3/PWGlear.3c 




































































0/10 2495 Dec 3 19:10 1986 /usr/pixar/man/man3/PWCopy.3c 

0/10 1243 Dec 3 19:10 1986 /usr/pixar/man/man3/PWGeneric.3c 

0/10 2850 Dec 3 19:10 1986 /usr/pixar/man/man3/PWMerge.3c 

0/10 967 Dec 3 19:10 1986 /usr/pixar/man/man3/PWNot.3c 

0/10 1501 Dec 3 19:10 1986 /usr/pixar/man/man3/PWShift.3c 

0/10 1203 Dec 3 19:10 1986 /usr/pixar/man/man3/PWShuffle.3c 

0/10 1129 Dec 3 19:10 1986 /usr/pixar/man/man3/PWSwap.3c 

0/10 1161 Dec 3 19:10 1986 /usr/pixar/man/man3/PWTranspose.3c 

0/10 3040 Dec 3 19:11 1986 /usr/pixar/man/man3/RGBAFCopy.3c 

0/10 1204 Dec 3 19:11 1986 /usr/pixar/man/man3/RSCopy.3c 

0/10 1398 Dec 3 19:11 1986 /usr/pixar/man/man3/SCCopy.3c 

0/10 4306 Dec 3 19:11 1986 /usr/pixar/man/man3/SFCopy.3c 

0/10 1332 Dec 3 19:11 1986 /usr/pixar/man/man3/SICopy.3c 

0/10 1208 Dec 3 19:11 1986 /usr/pixar/man/man3/SS4Map.3c 

0/10 1012 Dec 3 19:11 1986 /usr/pixar/man/man3/SSAxb.3c 

0/10 1738 Dec 3 19:11 1986 /usr/pixar/man/man3/SSCha.3c 

0/10 1102 Dec 3 19:11 1986 /usr/pixar/man/man3/SSComb.3c 

0/10 1211 Dec 3 19:11 1986 /usr/pixar/man/man3/SSCopy.3c 

0/10 992 Dec 3 19:11 1986 /usr/pixar/man/man3/SSCompare.3c 

0/10 1198 Dec 3 19:11 1986 /usr/pixar/man/man3/SSCopyComp.3c 

0/10 867 Dec 3 19:11 1986 /usr/pixar/man/man3/SSCopyRGBA.3c 

0/10 1242 Dec 3 19:11 1986 /usr/pixar/man/man3/SSCopyRGBALUT.3c 

0/10 3385 Dec 3 19:11 1986 /usr/pixar/man/man3/SSMerge.3c 

0/10 3160 Dec 3 19:11 1986 /usr/pixar/man/man3/SSPaint.3c 

0/10 2314 Dec 3 19:11 1986 /usr/pixar/man/man3/SSShuffle.3c 

0/10 1325 Dec 3 19:11 1986 /usr/pixar/man/man3/SYCopy.3c 

0/10 2507 Dec 3 19:11 1986 /usr/pixar/man/man3/TB.3c 

0/10 1836 Dec 3 19:11 1986 /usr/pixar/man/man3/TBCopy.3c 

0/10 1262 Dec 3 19:11 1986 /usr/pixar/man/man3/YFCopy.3c 

0/10 1232 Dec 3 19:11 1986 /usr/pixar/man/man3/YSCopy.3c 

0/10 18374 Dec 3 19:12 1986 /usr/pixar/man/man3/libpt.3c 

0/10 5627 Dec 3 19:10 1986 /usr/pixar/man/man3/PWResize.3c 

0/10 2781 Nov 28 13:31 1986 /usr/pixar/man/man3/PWShear.3c 

0/10 1092 Dec 3 19:11 1986 /usr/pixar/man/man3/SSHalve.3c 

0/10 12670 Dec 3 19:11 1986 /usr/pixar/man/man3/SSScale.3c 

0/10 2915 Dec 3 19:12 1986 /usr/pixar/man/man3/libpx.3c 

0/10 2437 Dec 3 19:12 1986 /usr/pixar/man/man3/stwarp.3c 

0/10 2477 Dec 3 19:12 1986 /usr/pixar/man/man3/stwarptable.3c 

0/10 2769 Dec 3 19:11 1986 /usr/pixar/man/man3/intro.3 

0/10 1458 Dec 3 20:01 1986 /usr/pixar/man/man3/ChadErrReport.3 

0/10 4842 Dec 3 20:01 1986 /usr/pixar/man/man3/ChadFrame.3 

0/10 1937 Dec 3 20:02 1986 /usr/pixar/man/man3/ChadGo.3 

0/10 524 Dec 3 19:09 1986 /usr/pixar/man/man3/ChapAbus.3 

0/10 1021 Dec 3 19:09 1986 /usr/pixar/man/man3/ChapAlu.3 

0/10 4501 Dec 3 19:09 1986 /usr/pixar/man/man3/ChapArchive.3 

0/10 604 Dec 3 19:09 1986 /usr/pixar/man/man3/ChapBpt.3 

0/10 828 Dec 3 19:09 1986 /usr/pixar/man/man3/ChapConfig.3 

0/10 834 Dec 3 19:09 1986 /usr/pixar/man/man3/ChapInst.3 

0/10 4461 Dec 3 19:09 1986 /usr/pixar/man/man3/ChapLoad.3 

0/10 1922 Dec 3 19:09 1986 /usr/pixar/man/man3/ChapLoadGo.3 

0/10 4178 Dec 3 19:09 1986 /usr/pixar/man/man3/ChapMMan.3 

0/10 915 Dec 3 19:09 1986 /usr/pixar/man/man3/ChapMbus.3 

0/10 1754 Dec 3 19:09 1986 /usr/pixar/man/man3/ChapOpen.3 

0/10 1044 Dec 3 19:09 1986 /usr/pixar/man/man3/ChapRam.3 

0/10 3476 Dec 3 19:09 1986 /usr/pixar/man/man3/ChapReg.3 

0/10 555 Dec 3 19:09 1986 /usr/pixar/man/man3/ChapReset.3 

0/10 2023 Dec 3 19:10 1986 /usr/pixar/man/man3/ChapRun.3 

0/10 984 Dec 3 19:10 1986 /usr/pixar/man/man3/ChapSbus.3 

0/10 2354 Dec 3 19:10 1986 /usr/pixar/man/man3/ChapSpad.3 

0/10 1462 Dec 3 19:10 1986 /usr/pixar/man/man3/ChapStack.3 

0/10 1195 Dec 3 19:10 1986 /usr/pixar/man/man3/ChapSym.3 

0/10 1595 Dec 3 19:10 1986 /usr/pixar/man/man3/ChapWait.3 

0/10 562 Dec 3 19:10 1986 /usr/pixar/man/man3/ChapXbar.3 

0/10 1478 Dec 3 19:10 1986 /usr/pixar/man/man3/DbOpen.3 

0/10 1356 Dec 3 19:10 1986 /usr/pixar/man/man3/DumiOpen.3 

0/10 1477 Dec 3 19:10 1986 /usr/pixar/man/man3/MctrlOpen.3 

































































r—r—r— 0/10 1040 Dec 3 19:10 1986 

r—r—r— 0/10 4468 Dec 3 19:10 1986 

r—r—r— 0/10 3336 Dec 3 19:10 1986 

r — r — r— 0/10 2898 Dec 3 19:10 1986 

r—r—r— 0/10 4724 Dec 3 19:10 1986 

r—r—r— 0/10 3165 Dec 3 19:10 1986 

r — r — r — o/10 1666 Dec 3 19:10 1986 

r—r—r— 0/10 1926 Dec 3 19:10 1986 

r — r — r — o/10 2608 Dec 3 19:11 1986 

r—r—r— 0/10 1703 Dec 3 19:11 1986 

r—r—r— 0/10 2705 Dec 3 19:11 1986 

r—r—r— 0/10 2162 Dec 3 19:11 1986 

r—r—r— 0/10 1399 Dec 3 19:11 1986 

r—r — r— 0/10 1408 Dec 3 19:11 1986 

r—r—r— 0/10 1403 Dec 3 19:11 1986 

r—r—r— 0/10 1249 Dec 3 19:11 1986 

r—r — r— 0/10 2180 Dec 3 19:11 1986 

r—r — r— 0/10 2048 Dec 3 19:11 1986 

r—r—r— 0/10 2874 Dec 3 19:11 1986 

r — r — r — o/10 1420 Dec 3 19:11 1986 

r—r—r— 0/10 1948 Dec 3 19:11 1986 

r—r—r— 0/10 1392 Dec 3 19:11 1986 

r — r — r — 0/10 1863 Dec 3 19:11 1986 

r—r—r— 0/10 2045 Dec 3 19:11 1986 

r—r—r— 0/10 2221 Dec 3 19:11 1986 

r—r—r— 0/10 2174 Dec 3 19:11 1986 

r—r—r— 0/10 1803 Dec 3 19:11 1986 

r—r—r— 0/10 8567 Dec 3 19:11 1986 

r— r—r — 0/10 2282 Dec 3 19:11 1986 

r—r—r— 0/10 2480 Dec 3 19:11 1986 

r—r—r— 0/10 979 Dec 3 19:11 1986 

r — r — r — o/10 4752 Dec 3 19:11 1986 

r—r —r— 0/10 1370 Dec 3 19:11 1986 

r—r—r— 0/10 1267 Dec 3 19:11 1986 

r—r—r— 0/10 1573 Dec 3 19:11 1986 

r—r—r— 0/10 1340 Dec 3 19:11 1986 

r—r—r— 0/10 1549 Dec 3 19:11 1986 

r—r—r— 0/10 1986 Dec 3 19:11 1986 

r—r—r— 0/10 2409 Dec 1 20:01 1986 

r—r—r— 0/10 1506 Dec 3 19:11 1986 

r—r—r— 0/10 2054 Dec 1 20:01 1986 

r— r — r— 0/10 1824 Dec 3 19:11 1986 

r—r—r— 0/10 1607 Dec 3 19:11 1986 

r—r—r— 0/10 1406 Dec 3 19:11 1986 

r—r— r — 0/10 1773 Dec 3 19:11 1986 

r—r—r— 0/10 1495 Dec 3 19:11 1986 

-—r—r— 0/10 1659 Dec 3 19:11 1986 

-—r—r— 0/10 1428 Dec 3 19:11 1986 

-—r—r— 0/10 2592 Dec 3 19:11 1986 

-—r—r— 0/10 2551 Dec 3 19:11 1986 

-—r—r— 0/10 2003 Dec 3 19:11 1986 

r — r — 0/10 1624 Dec 1 20:01 1986 

- — r—r — 0/10 2280 Dec 3 19:11 1986 

:— r — r — 0/10 2580 Dec 3 19:11 1986 

r—r— 0/10 7787 Dec 3 19:11 1986 

:—r—r— 0/10 6936 Dec 3 19:12 1986 

r—r—r— 0/10 10940 Dec 3 19:12 1986 

:—r—r— 0/10 7795 Dec 3 19:12 1986 

rwxrwxrwx 0/10 0 Dec 4 17:08 1986 
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/usr/pixar/man/man3/PicClose.3 
/usr/pixar/man/man3/PicCreat.3 
/usr/pixar/man/man3/PicDecode.3 
/usr/pixar/man/man3/PicEncode.3 
/usr/pixar/man/man3/PicFrame.3 
/usr/pixar/man/man3/PicLabel.3 
/usr/pixar/man/man3/PicRead.3 
/usr/pixar/man/man3/PirlArithmetic.3 
/usr/pixar/man/man3/PirlAxb.3 
/usr/pixar/man/man3/PirlBBox.3 
/usr/pixar/man/man3/PirlBegin.3 
/usr/pixar/man/man3/PirlBoxFilter.3 
/usr/pixar/man/man3/PirlCbars.3 
/usr/pixar/man/man3/PirlCha.3 
/usr/pixar/man/man3/PirlClamp.3 
/usr/pixar/man/man3/PirlClear.3 
/usr/pixar/man/man3/PirlConvolve.3 
/usr/pixar/man/man3/PirlConvolve3x3.3 
/usr/pixar/man/man3/PirlCopy.3 
/usr/pixar/man/man3/PirlCrc.3 
/usr/pixar/man/man3/PirlDisplay.3 
/usr/pixar/man/man3/PirlErrReport.3 
/usr/pixar/man/man3/PirlFrame.3 
/usr/pixar/man/man3/PirlGetBuf.3 
/usr/pixar/man/man3/PirlGetPic.3 
/usr/pixar/man/man3/PirlGetRaster.3 
/usr/pixar/man/man3/PirlHistogram.3 
/usr/pixar/man/man3/PirlLine.3 
/usr/pixar/man/man3/PirlMakeMap.3 
/usr/pixar/man/man3/PirlMap.3 
/usr/pixar/man/man3/PirlMapComp.3 
/usr/pixar/man/man3/PirlMerge.3 
/usr/pixar/man/man3/PirlNewPW.3 
/usr/pixar/man/man3/PirlNot.3 
/usr/pixar/man/man3/PirlRamp.3 
/usr/pixar/man/man3/PirlRange.3 
/usr/pixar/man/man3/PirlReflect.3 
/usr/pixar/man/man3/PirlResize.3 
/usr/pixar/man/man3/PirlRotate.3 
/usr/pixar/man/man3/PirlSetChannelMask.3 
/usr/pixar/man/man3/PirlShear.3 
/usr/pixar/man/man3/PirlShift.3 
/usr/pixar/man/man3/PirlShuffie.3 
/usr/pixar/man/man3/PirlSwap.3 
/usr/pixar/man/man3/PirlSweep.3 
/usr/pixar/man/man3/PirlTranspose.3 
/usr/pixar/man/man3/PirlZoom. 3 
/usr/pixar/man/man3/VideoCmap.3 
/usr/pixar/man/man3/VideoCursor.3 
/usr/pixar/man/man3/VideoDisplay.3 
/usr/pixar/man/man3/VideoFormat.3 
/usr/pixar/man/man3/VideoOpen.3 
/usr/pixar/man/man3/fbgetdef.3 
/usr/pixar/man/man3/getdevs.3 
/usr/pixar/man/man3/libchad.3 
/usr/pixar/man/man3/libpicio.3 
/usr/pixar/man/man3/libpirl.3 
/usr/pixar/man/man3/libpixar.3 
/usr/pixar/man/man4/ 
/usr/pixar/man/man4/chap.4 
/usr/pixar/man/man4/dumi.4 
/usr/pixar/man/man4/mctrl.4 
/usr/pixar/man/man4/video.4 
/usr/pixar/man/man5/ 
/usr/pixar/man/man5/chap.out.5 
/usr/pixar/man/man5/chapsym.5 
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4 17:08 1986 /usr/pixar/man/man7/ 

3 19:16 1986 /usr/pixar/man/man7/fbdefs.7 

4 17:08 1986 /usr/pixar/man/man8/ 

3 19:17 1986 /usr/pixar/man/man8/Diagnostic.8 
3 19:17 1986 /usr/pixar/man/man8/chconfig.8 
3 19:17 1986 /usr/pixar/man/man8/mctrl.8 

3 19:34 1986 /usr/pixar/man/pixar 

4 17:11 1986 /usr/pixar/fs/ 

4 17:11 1986 /usr/pixar/fs/.cshrc 
4 17:11 1986 /usr/pixar/fs/.login 
4 17:58 1986 /usr/pixar/Verify.bin 








merrell@flywheel 

tape2.list 

Mon Jul 13 09:20:58 1987 
Iw / Fluoride 



Fluoride 

Fluoride 

Fluoride 

Fluoride 

Fluoride 


flywheelrmerrell 
flywheelrmerrell 
flywheelrmerrell 
flywheelrmerrell 


Jobr tape2.list Dater Mon Jul 13 09r20r58 1987 
Jobr tape2.list Dater Mon Jul 13 09r20r58 1987 
Jobr tape2.list Dater Mon Jul 13 09r20r58 1987 
Jobr tape2.list Dater Mon Jul 13 09r20r58 1987 


flywheelrmerrell Jobr tape2.list Dater Mon Jul 13 09r20r58 1987 














rw-r-r- U/U 35797 Dec 5 21:04 1986 
rw-r—r— 0/10 41 Dec 2 13:47 1986 

rwxr-xr-x 0/10 0 Dec 5 20:54 1986 

rwxrwxrwx 0/10 0 Dec 5 20:55 1986 

rwxrwxrwx 0/10 0 Dec 5 20:55 1986 

rwxrwxrwx 0/10 0 Dec 5 20:54 1986 

r—r—r— 0/10 1395 Dec 2 15:53 1986 

r—r—r— 0/10 3934 Dec 2 15:26 1986 

r—r—r— 0/10 41466 Dec 2 15:27 1986 

r—r—r— 0/10 7812 Dec 2 15:27 1986 

r—r—r— 0/10 2557 Dec 2 15:27 1986 

r—r—r— 0/10 2521 Dec 2 15:27 1986 

r — r — r — o/10 2720 Dec 2 15:27 1986 

rw-r—r— 0/10 12878 Dec 2 18:03 1986 

rwxrwxrwx 0/10 0 Dec 5 20:54 1986 

r—r—r— 0/10 2073 Dec 2 15:53 1986 

r—r—r— 0/10 2562 Dec 2 15:27 1986 

r—r—r— 0/10 2564 Dec 2 15:27 1986 

r—r—r— 0/10 5210 Dec 2 15:27 1986 

r—r—r— 0/10 2841 Dec 2 15:27 1986 

r—r—r— 0/10 1994 Dec 2 15:27 1986 

r—r—r— 0/10 8901 Dec 2 15:27 1986 

r— r — r — o/10 6290 Dec 2 15:27 1986 

r—r—r— 0/10 2047 Dec 2 15:27 1986 

r—r—r— 0/10 717 Dec 2 15:27 1986 

rw-r—r— 0/10 4138 Dec 2 18:03 1986 

rwxrwxrwx 0/10 0 Dec 5 20:54 1986 

r — r — r — o/10 6695 Dec 3 11:26 1986 

r—r—r— 0/10 1842 Dec 2 15:28 1986 

r—r—r— 0/10 2492 Dec 2 15:28 1986 

r—r—r— 0/10 2360 Dec 2 15:28 1986 

r—r—r— 0/10 1335 Dec 2 15:28 1986 

r — r — r — o/10 1564 Dec 2 15:28 1986 

r—r—r— 0/10 2046 Dec 2 15:28 1986 

r—r—r— 0/10 1950 Dec 2 15:28 1986 

r — r — r — o/10 2444 Dec 2 15:28 1986 

r—r—r— 0/10 2277 Dec 2 15:28 1986 

r—r—r— 0/10 2773 Dec 2 15:28 1986 

r—r—r— 0/10 2138 Dec 2 15:28 1986 

r—r—r— 0/10 3488 Dec 2 15:28 1986 

r—r—r— 0/10 2445 Dec 2 15:28 1986 

r—r—r— 0/10 2044 Dec 2 15:28 1986 

r—r—r— 0/10 1289 Dec 2 15:28 1986 

r—r—r— 0/10 2338 Dec 2 15:28 1986 

r—r—r— 0/10 2710 Dec 2 15:28 1986 

r—r—r— 0/10 2029 Dec 2 15:28 1986 

r—r—r— 0/10 2374 Dec 2 15:28 1986 

r — r — r — o/10 16522 Dec 2 15:28 1986 

r—r—r— 0/10 10097 Dec 2 15:28 1986 

r— r—r— 0/10 14009 Dec 2 15:28 1986 

r—r—r— 0/10 2339 Dec 2 15:28 1986 

r—r —r— 0/10 2273 Dec 2 15:28 1986 

r—r—r— 0/10 3495 Dec 2 15:28 1986 

r—r—r— 0/10 1100 Dec 2 15:28 1986 

r—r—r—- 0/10 4268 Dec 2 15:28 1986 

r—r—r— 0/10 2220 Dec 2 15:28 1986 

r—r—r— 0/10 2933 Dec 2 15:28 1986 

r—r—r— 0/10 1090 Dec 2 15:28 1986 

r—r— r— 0/10 4275 Dec 2 15:28 1986 

r—r—r— 0/10 2221 Dec 2 15:28 1986 

r—r—r— 0/10 3108 Dec 2 15:28 1986 
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/usr/pixar/Verify.Gen.Src 
/usr/pixar/Version 
/usr/pixar/chap/ 

/usr/pixar/chap/src/ 

/usr/pixar/chap/src/lib/ 
/usr/pixar/chap/src/lib/libcolor/ 

/usr/pixar/chap/src/lib/libcolor/Makefile 
/usr/pixar/chap/src/lib/libcolor/rgb2xyY.s 
/usr/pixar/chap/src/lib/libcolor/xyY2dens. 
/usr/pixar/chap/src/lib/libcolor/dens 2 rgb. 
/usr/pixar/chap/src/lib/libcolor/rgb2XYZ.s 
/usr/pixar/chap/src/lib/libcolor/XYZ2rgb.s 
/usr/pixar/chap/src/lib/libcolor/mx3.s 
/usr/pixar/chap/src/lib/libcolor/libcolor. 
/usr/pixar/chap/src/lib/libpG/ 

/usr/pixar/chap/src/lib/libpG/Makefile 
/usr/pixar/chap/src/lib/libpG/saveb.s 
/usr/pixar/chap/src/lib/libpG/savei.s 
/usr/pixar/chap/src/lib/libpG/saver.s 
/usr/pixar/chap/src/lib/libpG/savev.s 
/usr/pixar/chap/src/lib/libpG/stack.s 
/usr/pixar/chap/src/lib/libpG/line.s 
/usr/pixar/chap/src/lib/libpG/text.vs 
/usr/pixar/chap/src/lib/libpG/dufftable.s 
/usr/pixar/chap/src/lib/libpG/table.h 
/usr/pixar/chap/src/lib/libpG/libpG.a 
/usr/pixar/chap/src/lib/libpt/ 

/usr/pixar/chap/src/lib/libpt/Makefile 

/usr/pixar/chap/src/lib/libpt/sic.s 
/usr/pixar/chap/src/lib/libpt/crc.s 
/usr/pixar/chap/src/lib/libpt/rsc.s 
/usr/pixar/chap/src/lib/libpt/ssclamp.s 
/usr/pixar/chap/src/lib/libpt/pwclear.s 
/usr/pixar/chap/src/lib/libpt/ss4map.s 
/usr/pixar/chap/src/lib/libpt/ssc.s 
/usr/pixar/chap/src/lib/libpt/ssm.s 
/usr/pixar/chap/src/lib/libpt/ssmi.s 
/usr/pixar/chap/src/lib/libpt/ssmo.s 
/usr/pixar/chap/src/lib/libpt/ccc.s 
/usr/pixar/chap/src/lib/libpt/ssp.s 
/usr/pixar/chap/src/lib/libpt/sspo.s 
/usr/pixar/chap/src/lib/libpt/pwaxb.s 
/usr/pixar/chap/src/lib/libpt/sscmp.s 
/usr/pixar/chap/src/lib/libpt/ssmout.s 
/usr/pixar/chap/src/lib/libpt/fcc.s 
/usr/pixar/chap/src/lib/libpt/ssaxb.s 
/usr/pixar/chap/src/lib/libpt/sspc.s 
/usr/pixar/chap/src/lib/libpt/fsc.s 
/usr/pixar/chap/src/lib/libpt/pw.s 
/usr/pixar/chap/src/lib/libpt/sfc.s 
/usr/pixar/chap/src/lib/libpt/ssmu.s 
/usr/pixar/chap/src/lib/libpt/pwcha.s 
/usr/pixar/chap/src/lib/libpt/sscha.s 

/usr/pixar/chap/src/lib/libpt/pwclamp.s 
/usr/pixar/chap/src/lib/libpt/pwcopy.s 
/usr/pixar/chap/src/lib/libpt/pwgeneric.s 
/usr/pixar/chap/src/lib/libpt/pwmerge.s 
/usr/pixar/chap/src/lib/libpt/pwnot.s 
/usr/pixar/chap/src/lib/libpt/pwshift.s 
/usr/pixar/chap/src/lib/libpt/pwshuffle.s 
/usr/pixar/chap/src/lib/libpt/pwswap.s 
/usr/pixar/chap/src/lib/libpt/pwtranspose. 
/usr/pixar/chap/src/lib/libpt/ssnot.s 
/usr/pixar/chap/src/lib/libpt/sscomb.s 
/ usr/pixar/chap/src/lib/libpt/ssma.s 
/usr/pixar/chap/src/lib/libpt/shuffie.s 
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0/10 2737 Dec 2 15:28 1986 /usr/pixar/chap/src/lib/libpt/ffc.s 

0/10 2042 Dec 2 15:28 1986 /usr/pixar/chap/src/lib/libpt/pwmapc.s 

0/10 3987 Dec 2 15:28 1986 /usr/pixar/chap/src/lib/libpt/sscompc.s 

0/10 1012 Dec 2 15:28 1986 /usr/pixar/chap/src/lib/libpt/yap.h 

0/10 1803 Dec 2 15:28 1986 /usr/pixar/chap/src/lib/libpt/pw4map.s 

0/10 131976 Dec 3 11:32 1986 /usr/pixar/chap/src/lib/libpt/libpt.a 

0/10 0 Dec 5 20:55 1986 /usr/pixar/chap/src/lib/libpx/ 

0/10 2847 Dec 2 15:54 1986 /usr/pixar/chap/src/lib/libpx/Makefile 

0/10 3622 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/hd4.s 

0/10 3599 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/vu4.s 

0/10 4839 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/vd4.s 

0/10 2031 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/hul.s 

0/10 4194 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/magltable.s 

0/10 3044 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/hu2.s 

0/10 3082 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/hd2.s 

0/10 5674 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/mag2table.s 

0/10 3947 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/min2table.s 

0/10 3865 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/minltable.s 

0/10 3273 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/vd2.s 

0/10 2967 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/vu2.s 

0/10 1964 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/vdl.s 

0/10 5346 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/setstwarptak 

0/10 1914 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/vul.s 

0/10 7930 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/stwarp.s 

0/10 1903 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/ssshalve.s 

0/10 4422 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/min4table.s 

0/10 5927 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/mag4table.s 

0/10 1322 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/makereciptat 

0/10 1342 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/makerecl6_2£ 

0/10 4656 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/makefilter4t 

0/10 3526 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/hu4.s 

0/10 3152 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/rotxx.s 

0/10 3126 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/rotyx.s 

0/10 3135 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/rotyy.s 

0/10 3486 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/pwshear.s 

0/10 10067 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/pwresize.s 

0/10 3121 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/shearxx.s 

0/10 3120 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/shearxy.s 

0/10 3117 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/shearyx.s 

0/10 3125 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/shearyy.s 

0/10 2815 Dec 2 15:29 1986 /usr/pixar/chap/src/lib/libpx/pwshear clr. 

0/10 2850 Dec 2 18:10 1986 /usr/pixar/chap/src/lib/libpx/recl6 256.s 

0/10 48267 Dec 2 18:11 1986 /usr/pixar/chap/src/lib/libpx/filter4table 

0/10 51782 Dec 2 18:12 1986 /usr/pixar/chap/src/lib/libpx/libpx.a 

0/10 0 Dec 5 20:55 1986 /usr/pixar/chap/src/lib/libpip/ 

0/10 2688 Dec 2 15:53 1986 /usr/pixar/chap/src/lib/libpip/Makefile 

0/10 2603 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/dhg.s 

0/10 2269 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/ssconv.s 

0/10 2595 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/pwc33.s 

0/10 2707 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/pwc33s.s 

0/10 2757 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/pwconv.s 

0/10 1655 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/pwdiv.s 

0/10 1944 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/pwhg.s 

0/10 1655 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/pwmul.s 

0/10 1534 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/pwrange.s 

0/10 1655 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/pwsub.s 

0/10 1319 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/ssadd.s 

0/10 1699 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/ssdiv.s 

0/10 1343 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/ssmul.s 

0/10 1163 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/ssrange.s 

0/10 1319 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/sssub.s 

0/10 1656 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/pwadd.s 

0/10 3044 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/pwboxfilter 

0/10 2393 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/ssboxfilter 

0/10 6290 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/c55s.s 

0/10 4898 Dec 2 15:27 1986 /usr/pixar/chap/src/lib/libpip/c33s.s 
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15:27 1986 /usr/pixar/chap/src/lib/libpip/c33.s 
15:27 1986 /usr/pixar/chap/src/lib/libpip/sscrc.s 
15:27 1986 /usr/pixar/chap/src/lib/libpip/pwcrc.s 
15:27 1986 /usr/pixar/chap/src/lib/libpip/bbox.s 
15:27 1986 /usr/pixar/chap/src/lib/libpip/ssconv2.s 
15:28 1986 /usr/pixar/chap/src/lib/libpip/ssconv4.s 
15:28 1986 /usr/pixar/chap/src/lib/libpip/edge.s 
15:28 1986 /usr/pixar/chap/src/lib/libpip/pwline.s 
18:05 1986 /usr/pixar/chap/src/lib/libpip/libpip.a 
20:55 1986 /usr/pixar/chap/src/lib/libpm/ 

15:54 1986 /usr/pixar/chap/src/lib/libpm/Makefile 
15:29 1986 /usr/pixar/chap/src/lib/libpm/recl5_256.s 
15:29 1986 /usr/pixar/chap/src/lib/libpm/reciprocal.s 
15:29 1986 /usr/pixar/chap/src/lib/libpm/recsqrtl61.s 
15:29 1986 /usr/pixar/chap/src/lib/libpm/recsqrt321.s 
15:29 1986 /usr/pixar/chap/src/lib/libpm/rrand.s 
15:29 1986 /usr/pixar/chap/src/lib/libpm/sqrtl6.s 
15:29 1986 /usr/pixar/chap/src/lib/libpm/sqrtl61.s 
15:29 1986 /usr/pixar/chap/src/lib/libpm/sqrt321.s 
15:29 1986 /usr/pixar/chap/src/lib/libpm/xp2.s 
15:29 1986 /usr/pixar/chap/src/lib/libpm/xp4.s 
15:29 1986 /usr/pixar/chap/src/lib/libpm/matvec32.s 
15:29 1986 /usr/pixar/chap/src/lib/libpm/matmul32.s 
15:29 1986 /usr/pixar/chap/src/lib/libpm/makerrlist.c 
15:29 1986 /usr/pixar/chap/src/lib/libpm/matmull6.s 
15:29 1986 /usr/pixar/chap/src/lib/libpm/fsqrt.s 
15:29 1986 /usr/pixar/chap/src/lib/libpm/radialdist.s 
18:12 1986 /usr/pixar/chap/src/lib/libpm/rrlist.s 
18:13 1986 /usr/pixar/chap/src/lib/libpm/libpm.a 
20:55 1986 /usr/pixar/chap/src/lib/libchad/ 

15:52 1986 /usr/pixar/chap/src/lib/libchad/Makefile 
15:26 1986 /usr/pixar/chap/src/lib/libchad/newgetw.s 
15:26 1986 /usr/pixar/chap/src/lib/libchad/newcmds.s 
15:26 1986 /usr/pixar/chap/src/lib/libchad/newloop.s 
15:26 1986 /usr/pixar/chap/src/lib/libchad/pxlio.s 
15:26 1986 /usr/pixar/chap/src/lib/libchad/chad.s 
15:26 1986 /usr/pixar/chap/src/lib/libchad/fbregs.h 
18:03 1986 /usr/pixar/chap/src/lib/libchad/libchad.a 
20:55 1986 /usr/pixar/chap/src/lib/libpicio/ 

15:53 1986 /usr/pixar/chap/src/lib/libpicio/Makefile 
15:28 1986 /usr/pixar/chap/src/lib/libpicio/duff8Tol2 
15:28 1986 /usr/pixar/chap/src/lib/libpicio/duff12To8 
15:28 1986 /usr/pixar/chap/src/lib/libpicio/picio.s 
18:10 1986 /usr/pixar/chap/src/lib/libpicio/libpicio. 
14:23 1986 /usr/pixar/chap/src/lib/Makefile 
20:55 1986 /usr/pixar/chap/src/bin/ 

15:54 1986 /usr/pixar/chap/src/bin/Makefile 
15:29 1986 /usr/pixar/chap/src/bin/config.s 
18:13 1986 /usr/pixar/chap/src/bin/config 
14:23 1986 /usr/pixar/chap/src/Makefile 
20:58 1986 /usr/pixar/demo/ 

13:24 1986 /usr/pixar/demo/Makefile 
20:57 1986 /usr/pixar/demo/lib/ 

13:16 1986 /usr/pixar/demo/lib/libfbtool.a 
13:16 1986 /usr/pixar/demo/lib/cube.a 
13:16 1986 /usr/pixar/demo/lib/fht 
13:16 1986 /usr/pixar/demo/lib/blits.ucode 
13:16 1986 /usr/pixar/demo/lib/t.out.d 
13:16 1986 /usr/pixar/demo/lib/t.stop 
20:58 1986 /usr/pixar/demo/src/ 

20:57 1986 /usr/pixar/demo/src/fft/ 

13:16 1986 /usr/pixar/demo/src/fft/fftdemo.c 
13:16 1986 /usr/pixar/demo/src/fft/fht.h 
13:16 1986 /usr/pixar/demo/src/fft/convolve.s 
13:16 1986 /usr/pixar/demo/src/fft/fft.s 
13:16 1986 /usr/pixar/demo/src/fft/io.s 
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3 13:16 1986 /usr/pixar/demo/src/fft/main.s 
3 13:16 1986 /usr/pixar/demo/src/fft/math.s 
3 13:16 1986 /usr/pixar/demo/src/fft/perm_table.s 
3 13:17 1986 /usr/pixar/demo/src/fft/trig_table.s 
3 13:17 1986 /usr/pixar/demo/src/fft/Makefile 
3 13:17 1986 /usr/pixar/demo/src/fft/fht 
3 13:17 1986 /usr/pixar/demo/src/fft/fftdemo 
5 20:58 1986 /usr/pixar/demo/src/fbtool/ 

5 20:57 1986 /usr/pixar/demo/src/fbtool/cube/ 

3 13:18 1986 /usr/pixar/demo/src/fbtool/cube/Cubelcon 
3 13:18 1986 /usr/pixar/demo/src/fbtool/cube/Makefile 
3 13:18 1986 /usr/pixar/demo/src/fbtool/cube/cubetool.c 
3 13:18 1986 /usr/pixar/demo/src/fbtool/cube/rottable.c 
3 13:18 1986 /usr/pixar/demo/src/fbtool/cube/ax.s 
3 13:18 1986 /usr/pixar/demo/src/fbtool/cube/axial.s 
3 13:18 1986 /usr/pixar/demo/src/fbtool/cube/cor.s 
3 13:18 1986 /usr/pixar/demo/src/fbtool/cube/coronal.s 
3 13:18 1986 /usr/pixar/demo/src/fbtool/cube/drawcube.s 
3 13:18 1986 /usr/pixar/demo/src/fbtool/cube/sag.s 
3 13:18 1986 /usr/pixar/demo/src/fbtool/cube/sagital.s 
3 13:18 1986 /usr/pixar/demo/src/fbtool/cube/sscompc.s 
3 13:18 1986 /usr/pixar/demo/src/fbtool/cube/cube.a 
3 13:18 1986 /usr/pixar/demo/src/fbtool/cube/cuberamp.c 
3 13:19 1986 /usr/pixar/demo/src/fbtool/cube/cuberamp 
5 20:58 1986 /usr/pixar/demo/src/fbtool/libfbtool/ 

3 13:19 1986 /usr/pixar/demo/src/fbtool/libfbtool/Makef 
3 13:19 1986 /usr/pixar/demo/src/fbtool/libfbtool/item. 
3 13:19 1986 /usr/pixar/demo/src/fbtool/libfbtool/conf1 
3 13:19 1986 /usr/pixar/demo/src/fbtool/libfbtool/fbtat 
3 13:19 1986 /usr/pixar/demo/src/fbtool/libfbtool/test. 
3 13:19 1986 /usr/pixar/demo/src/fbtool/libfbtool/FBIcc 
3 13:19 1986 /usr/pixar/demo/src/fbtool/libfbtool/fbtoc 
3 13:19 1986 /usr/pixar/demo/src/fbtool/libfbtool/sampl 
3 13:19 1986 /usr/pixar/demo/src/fbtool/libfbtool/libft 
5 20:58 1986 /usr/pixar/demo/src/fbtool/include/ 

3 13:20 1986 /usr/pixar/demo/src/fbtool/include/fbt_imp 
3 13:20 1986 /usr/pixar/demo/src/fbtool/include/fbtattr 
3 13:20 1986 /usr/pixar/demo/src/fbtool/include/fbtool. 
3 13:20 1986 /usr/pixar/demo/src/fbtool/include/video.c 
3 13:20 1986 /usr/pixar/demo/src/fbtool/include/rottabl 
5 20:58 1986 /usr/pixar/demo/src/fbtool/magloop/ 

3 13:20 1986 /usr/pixar/demo/src/fbtool/magloop/MLIcon 
3 13:20 1986 /usr/pixar/demo/src/fbtool/magloop/magloop 
3 13:20 1986 /usr/pixar/demo/src/fbtool/magloop/Makefil 
5 20:58 1986 /usr/pixar/demo/src/fbtool/video/ 

3 13:22 1986 /usr/pixar/demo/src/fbtool/video/ClockCur 
3 13:22 1986 /usr/pixar/demo/src/fbtool/video/Makefile 
3 13:22 1986 /usr/pixar/demo/src/fbtool/video/VIcon 
3 13:22 1986 /usr/pixar/demo/src/fbtool/video/vtool.c 
3 13:22 1986 /usr/pixar/demo/src/fbtool/video/vt.c 
3 13:22 1986 /usr/pixar/demo/src/fbtool/fbt_merge.c 
3 13:22 1986 /usr/pixar/demo/src/fbtool/Makefile 
3 13:22 1986 /usr/pixar/demo/src/fbtool/fbt__merge 
5 20:58 1986 /usr/pixar/demo/src/treestuff/ 

3 13:22 1986 /usr/pixar/demo/src/treestuff/t.stop 
3 13:22 1986 /usr/pixar/demo/src/treestuff/Makefile 
3 13:22 1986 /usr/pixar/demo/src/treestuff/blit.c 
3 13:22 1986 /usr/pixar/demo/src/treestuff/t.out.d 
3 13:22 1986 /usr/pixar/demo/src/treestuff/blits.s 
3 13:22 1986 /usr/pixar/demo/src/treestuff/blits.ucode 
3 13:22 1986 /usr/pixar/demo/src/treestuff/blit 
3 13:22 1986 /usr/pixar/demo/src/Makefile 
3 13:22 1986 /usr/pixar/demo/src/Demo 
5 20:58 1986 /usr/pixar/demo/bin/ 

3 13:23 1986 /usr/pixar/demo/bin/fbt_merge 
3 13:23 1986 /usr/pixar/demo/bin/videotool 
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/usr/pixar/demo/bin/cubetool 
/usr/pixar/demo/bin/magloop 
/usr/pixar/demo/bin/fftdemo 
/usr/pixar/demo/bin/Demo 
/usr/pixar/demo/bin/blit 
/usr/pixar/demo/bin/cuberamp 
/usr/pixar/host/ 

/usr/pixar/host/src/ 

/usr/pixar/host/src/lib/ 

/usr/pixar/host/src/lib/libG/ 

/usr/pixar/host/src/lib/libG/profiled/ 
/usr/pixar/host/src/lib/libaa/ 

/usr/pixar/host/src/lib/libaa/profiled/ 
/usr/pixar/host/src/lib/libaa/aa_save.c 
/usr/pixar/host/src/lib/libaa/aaetof.c 
/usr/pixar/host/src/lib/libaa/aahelp.c 
/usr/pixar/host/src/lib/libaa/aais.c 
/usr/pixar/host/src/lib/libaa/aaparse.c 
/usr/pixar/host/src/lib/libaa/aarg.c 
/usr/pixar/host/src/lib/libaa/aarg.i.c 
/usr/pixar/host/src/lib/libaa/aawin.c 
/usr/pixar/host/src/lib/libaa/aarg.h 
/usr/pixar/host/src/lib/libaa/aarg.globals 
/usr/pixar/host/src/lib/libaa/aarg.i.h 
/usr/pixar/host/src/lib/libaa/Makefile 
/usr/pixar/host/src/lib/libaa/aarg.3 
/usr/pixar/host/src/lib/libaa/aarg.i.3 
/usr/pixar/host/src/lib/libaa/aachkarg.c 
/usr/pixar/host/src/lib/libaa/aaonoff.c 
/usr/pixar/host/src/lib/libaa/std.h 
/usr/pixar/host/src/lib/libchad/ 

/usr/pixar/host/src/lib/libchad/profiled/ 
/usr/pixar/host/src/lib/libchad/Makefile 
/usr/pixar/host/src/lib/libchad/chadram. c 
/usr/pixar/host/src/lib/libchad/chad.h 
/usr/pixar/host/src/lib/libchad/chad.c 
/usr/pixar/host/src/lib/libchad/Chad.h 
/usr/pixar/host/src/lib/libchad/chadalloc. 
/usr/pixar/host/src/lib/libchad/nvideo.c 
/usr/pixar/host/src/lib/libchad/chadio.c 
/usr/pixar/host/src/lib/libchad/chaddevs.c 
/usr/pixar/host/src/lib/libchad/chaddevsca 
/usr/pixar/host/src/lib/libchad/ncursor.c 
/usr/pixar/host/src/lib/libchad/font.h 
/usr/pixar/host/src/lib/libpicio/ 

/usr/pixar/host/src/lib/libpicio/profiled/ 
/usr/pixar/host/src/lib/libpicio/Makefile 
/usr/pixar/host/src/lib/libpicio/screen.h 
/usr/pixar/host/src/lib/libpicio/cpu.h 
/usr/pixar/host/src/lib/libpicio/piccode.h 
/usr/pixar/host/src/lib/libpicio/rpacemu.h 
/usr/pixar/host/src/lib/libpicio/picio.h 
/usr/pixar/host/src/lib/libpicio/picture.h 
/usr/pixar/host/src/lib/libpicio/PD.c 
/usr/pixar/host/src/lib/libpicio/Pclose.c 
/usr/pixar/host/src/lib/libpicio/Pcreat.c 
/usr/pixar/host/src/lib/libpicio/Pfind.c 
/usr/pixar/host/src/lib/libpicio/Popen.c 
/usr/pixar/host/src/lib/libpicio/Preadbuff 
/usr/pixar/host/src/lib/libpicio/Preadfb.c 
/usr/pixar/host/src/lib/libpicio/Pwritebuf 
/usr/pixar/host/src/lib/libpicio/Pwritefb. 
/usr/pixar/host/src/lib/libpicio/dectile.c 
/usr/pixar/host/src/lib/libpicio/dectileft 
/usr/pixar/host/src/lib/libpicio/deczero.c 
/usr/pixar/host/src/lib/libpicio/enctile.c 
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5 12:55 1986 /usr/pixar/host/src/lib/libpicio/encfb.c 
5 12:55 1986 /usr/pixar/host/src/lib/libpicio/encfb 8 bit 
5 12:55 1986 /usr/pixar/host/src/lib/libpicio/encfbl 2 bi 
5 12:55 1986 /usr/pixar/host/src/lib/libpicio/histograrr 
5 12:55 1986 /usr/pixar/host/src/lib/libpicio/picbyte.c 
5 12:55 1986 /usr/pixar/host/src/lib/libpicio/piclabel. 
5 12:55 1986 /usr/pixar/host/src/lib/libpicio/pixar.c 
5 12:56 1986 /usr/pixar/host/src/lib/libpicio/pixarfr.c 
5 12:55 1986 /usr/pixar/host/src/lib/libpicio/Pputframe 
5 12:55 1986 /usr/pixar/host/src/lib/libpicio/Pgetframc 
5 12:55 1986 /usr/pixar/host/src/lib/libpicio/dectilefr 
5 12:55 1986 /usr/pixar/host/src/lib/libpicio/encfr.c 
5 12:55 1986 /usr/pixar/host/src/lib/libpicio/encfr 8 bit 
5 12:55 1986 /usr/pixar/host/src/lib/libpicio/encfrl 2 bi 
5 12:54 1986 /usr/pixar/host/src/lib/libpicio/Plerpfb.c 
5 12:56 1986 /usr/pixar/host/src/lib/libpicio/rpacmacs. 
5 12:56 1986 /usr/pixar/host/src/lib/libpicio/rpac.h 
5 12:55 1986 /usr/pixar/host/src/lib/libpicio/mkduff.c 
5 12:56 1986 /usr/pixar/host/src/lib/libpicio/duff.c 
2 17:02 1986 /usr/pixar/host/src/lib/libpicio/mkduff 
5 12:55 1986 /usr/pixar/host/src/lib/libpicio/wops.c 
5 20:56 1986 /usr/pixar/host/src/lib/libpirl/ 

5 20:56 1986 /usr/pixar/host/src/lib/libpirl/profiled/ 

5 19:48 1986 /usr/pixar/host/src/lib/libpirl/Makefile 
5 12:58 1986 /usr/pixar/host/src/lib/libpirl/begin.c 
5 12:56 1986 /usr/pixar/host/src/lib/libpirl/cbars.c 
5 12:58 1986 /usr/pixar/host/src/lib/libpirl/copy.c 
5 12:57 1986 /usr/pixar/host/src/lib/libpirl/swap.c 
5 12:57 1986 /usr/pixar/host/src/lib/libpirl/clear.c 
5 12:57 1986 /usr/pixar/host/src/lib/libpirl/transpose. 
5 12:57 1986 /usr/pixar/host/src/lib/libpirl/reflect.c 
5 12:56 1986 /usr/pixar/host/src/lib/libpirl/cha.c 
5 12:57 1986 /usr/pixar/host/src/lib/libpirl/pw.c 
5 12:57 1986 /usr/pixar/host/src/lib/libpirl/shift.c 
5 12:56 1986 /usr/pixar/host/src/lib/libpirl/map.c 
5 12:56 1986 /usr/pixar/host/src/lib/libpirl/merge.c 
5 12:56 1986 /usr/pixar/host/src/lib/libpirl/mask.c 
5 12:57 1986 /usr/pixar/host/src/lib/libpirl/shuffie.c 
5 12:56 1986 /usr/pixar/host/src/lib/libpirl/clamp.c 
5 12:57 1986 /usr/pixar/host/src/lib/libpirl/not.c 
5 12:56 1986 /usr/pixar/host/src/lib/libpirl/axb.c 
5 12:56 1986 /usr/pixar/host/src/lib/libpirl/convolvelc 
5 12:56 1986 /usr/pixar/host/src/lib/libpirl/c33.c 
5 12:56 1986 /usr/pixar/host/src/lib/libpirl/c33s.c 
5 12:58 1986 /usr/pixar/host/src/lib/libpirl/boxfilter. 

5 12:56 1986 /usr/pixar/host/src/lib/libpirl/add.c 
5 12:57 1986 /usr/pixar/host/src/lib/libpirl/sub.c 
5 12:57 1986 /usr/pixar/host/src/lib/libpirl/mul.c 
5 12:56 1986 /usr/pixar/host/src/lib/libpirl/div.c 
5 12:57 1986 /usr/pixar/host/src/lib/libpirl/getframe.c 
5 12:57 1986 /usr/pixar/host/src/lib/libpirl/putframe.c 
5 12:56 1986 /usr/pixar/host/src/lib/libpirl/hg.c 
5 12:57 1986 /usr/pixar/host/src/lib/libpirl/range.c 
5 12:57 1986 /usr/pixar/host/src/lib/libpirl/sweep.c 
5 12:57 1986 /usr/pixar/host/src/lib/libpirl/ramp.c 
5 12:57 1986 /usr/pixar/host/src/lib/libpirl/error.c 
5 12:57 1986 /usr/pixar/host/src/lib/libpirl/cbars.h 
5 12:58 1986 /usr/pixar/host/src/lib/libpirl/resize.c 
5 12:58 1986 /usr/pixar/host/src/lib/libpirl/crc.c 
5 12:58 1986 /usr/pixar/host/src/lib/libpirl/buf.c 
5 12:58 1986 /usr/pixar/host/src/lib/libpirl/getsv.c 
5 12:58 1986 /usr/pixar/host/src/lib/libpirl/mapc.c 
5 12:58 1986 /usr/pixar/host/src/lib/libpirl/bbox.c 
5 12:58 1986 /usr/pixar/host/src/lib/libpirl/getraster. 

5 12:57 1986 /usr/pixar/host/src/lib/libpirl/fbinq.c 
5 12:58 1986 /usr/pixar/host/src/lib/libpirl/pirl.h 
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1306 Dec 
1699 Dec 
3267 Dec 
14694 Dec 
8065 Dec 
1927 Dec 
4913 Dec 
748 Dec 
0 Dec 
0 Dec 
0 Dec 
29016 Dec 
2399 Dec 

1195 Dec 
1199 Dec 
1201 Dec 

19048 Dec 
1203 Dec 
2406 Dec 
2006 Dec 
2333 Dec 
25298 Dec 
2070 Dec 
1768 Dec 
1529 Dec 
3387 Dec 
1192 Dec 

1196 Dec 
1198 Dec 
1111 Dec 
1225 Dec 
1279 Dec 
1229 Dec 
1248 Dec 
1231 Dec 
1719 Dec 
2842 Dec 
1425 Dec 
2006 Dec 
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5 12:57 1986 /usr/pixar/host/src/lib/libpirl/merge.h 
5 12:58 1986 /usr/pixar/host/src/lib/libpirl/pirlxform. 
5 12:58 1986 /usr/pixar/host/src/lib/libpirl/prexform.c 
5 12:58 1986 /usr/pixar/host/src/lib/libpirl/pirlline.c 
5 19:48 1986 /usr/pixar/host/src/lib/libpirl/affine.c 
5 12:58 1986 /usr/pixar/host/src/lib/libpirl/pirlmapcoir 
5 12:58 1986 /usr/pixar/host/src/lib/libpirl/scale.c 
5 12:58 1986 /usr/pixar/host/src/lib/libpirl/mapn.c 
5 20:56 1986 /usr/pixar/host/src/lib/libpixar/ 

5 20:56 1986 /usr/pixar/host/src/lib/libpixar/chap/ 

5 20:56 1986 /usr/pixar/host/src/lib/libpixar/chap/prof 
5 12:58 1986 /usr/pixar/host/src/lib/libpixar/chap/Make 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/afil 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/allc 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/allc 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/allc 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/arch 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/clrfc 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/cont 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/dump 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/dump 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/dyna 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/errl 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/errc 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/exec 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/fill 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/free 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/free 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/free 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/getc 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/getf 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/getn 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/geti 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/run. 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/gets 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/halt 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/loac 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/loac 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/loac 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/loac 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/mman 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/oper 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/reac 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/reac 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/reac 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/reac 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/reac 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/reac 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/reac 
5 12:59 1986 /usr/pixar/host/src/lib/libpixar/chap/reac 
5 13:00 1986 /usr/pixar/host/src/lib/libpixar/chap/reac 
5 13:00 1986 /usr/pixar/host/src/lib/libpixar/chap/reac 
5 13:00 1986 /usr/pixar/host/src/lib/libpixar/chap/reac 
5 13:00 1986 /usr/pixar/host/src/lib/libpixar/chap/reac 
5 13:00 1986 /usr/pixar/host/src/lib/libpixar/chap/reac 
5 13:00 1986 /usr/pixar/host/src/lib/libpixar/chap/reac 
5 13:00 1986 /usr/pixar/host/src/lib/libpixar/chap/rese 
5 13:00 1986 /usr/pixar/host/src/lib/libpixar/chap/rese 
5 13:00 1986 /usr/pixar/host/src/lib/libpixar/chap/runa 
5 13:00 1986 /usr/pixar/host/src/lib/libpixar/chap/setfc 
5 13:00 1986 /usr/pixar/host/src/lib/libpixar/chap/setc 
5 13:00 1986 /usr/pixar/host/src/lib/libpixar/chap/step 
5 13:00 1986 /usr/pixar/host/src/lib/libpixar/chap/symt 
5 13:00 1986 /usr/pixar/host/src/lib/libpixar/chap/wait 
5 13:00 1986 /usr/pixar/host/src/lib/libpixar/chap/writ 
5 13:00 1986 /usr/pixar/host/src/lib/libpixar/chap/writ 
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/usr/pixar/host/src/lib/libpixar/chap/writ 
/usr/pixar/host/src/lib/libpixar/chap/writ 
/usr/pixar/host/src/lib/libpixar/chap/writ 
/usr/pixar/host/src/lib/libpixar/chap/writ 
/usr/pixar/host/src/lib/libpixar/chap/writ 
/usr/pixar/host/src/lib/libpixar/chap/writ 
/usr/pixar/host/src/lib/libpixar/chap/writ 
/usr/pixar/host/src/lib/libpixar/chap/writ 
/usr/pixar/host/src/lib/libpixar/chap/load 
/usr/pixar/host/src/lib/libpixar/chap/flac 
/usr/pixar/host/src/lib/libpixar/chap/sett 
/usr/pixar/host/src/lib/libpixar/chap/mall 
/usr/pixar/host/src/lib/libpixar/chap/chap 
/usr/pixar/host/src/lib/libpixar/chap/chap 
/usr/pixar/host/src/lib/libpixar/chap/alu. 
/usr/pixar/host/src/lib/libpixar/chap/chap 
/usr/pixar/host/src/lib/libpixar/chap/chap 
/usr/pixar/host/src/lib/libpixar/chap/chap 
/usr/pixar/host/src/lib/libpixar/chap/relc 
/usr/pixar/host/src/lib/libpixar/chap/chap 
/usr/pixar/host/src/lib/libpixar/chap/mmar 
/usr/pixar/host/src/lib/libpixar/chap/pbus 
/usr/pixar/host/src/lib/libpixar/chap/diac 
/usr/pixar/host/src/lib/libpixar/chap/yapk 
/usr/pixar/host/src/lib/libpixar/chap/pbus 
/usr/pixar/host/src/lib/libpixar/chap/pw.h 
/usr/pixar/host/src/lib/libpixar/chap/ucal 
/usr/pixar/host/src/lib/libpixar/chap/wrur 
/usr/pixar/host/src/lib/libpixar/chap/envl 
/usr/pixar/host/src/lib/libpixar/chap/chap 
/usr/pixar/host/src/lib/libpixar/chap/chap 
/usr/pixar/host/src/lib/libpixar/video/ 
/usr/pixar/host/src/lib/libpixar/video/prc 
/usr/pixar/host/src/lib/libpixar/video/cur 
/usr/pixar/host/src/lib/libpixar/video/cur 
/usr/pixar/host/src/lib/libpixar/video/cur 
/usr/pixar/host/src/lib/libpixar/video/cur 
/usr/pixar/host/src/lib/libpixar/video/cur 
/usr/pixar/host/src/lib/libpixar/video/cur 
/usr/pixar/host/src/lib/libpixar/video/cur 
/usr/pixar/host/src/lib/libpixar/video/Mak 
/usr/pixar/host/src/lib/libpixar/video/cmc 
/usr/pixar/host/src/lib/libpixar/video/cms 
/usr/pixar/host/src/lib/libpixar/video/cur 
/usr/pixar/host/src/lib/libpixar/video/cur 
/usr/pixar/host/src/lib/libpixar/video/cur 
/usr/pixar/host/src/lib/libpixar/video/cur 
/usr/pixar/host/src/lib/libpixar/video/cur 
/usr/pixar/host/src/lib/libpixar/video/get 
/usr/pixar/host/src/lib/libpixar/video/get 
/usr/pixar/host/src/lib/libpixar/video/pos 
/usr/pixar/host/src/lib/libpixar/video/set 
/usr/pixar/host/src/lib/libpixar/video/vop 
/usr/pixar/host/src/lib/libpixar/video/zoc 
/usr/pixar/host/src/lib/libpixar/video/gac 
/usr/pixar/host/src/lib/libpixar/video/cur 
/usr/pixar/host/src/lib/libpixar/video/vic 
/usr/pixar/host/src/lib/libpixar/video/vic 
/usr/pixar/host/src/lib/libpixar/profiled/ 
/usr/pixar/host/src/lib/libpixar/profiled/ 
/usr/pixar/host/src/lib/libpixar/Makefile 
/usr/pixar/host/src/lib/libpixar/disk.c 
/usr/pixar/host/src/lib/libpixar/dumi.c 
/usr/pixar/host/src/lib/libpixar/mctrl.c 
/usr/pixar/host/src/lib/libpixar/pixar.h 
/usr/pixar/host/src/lib/libpixar/dumireg.h 
















































r—r—r— 559/10 6785 Dec 5 13:02 1986 

r—r—r— 559/10 3174 Dec 5 13:02 1986 

r—r—r— 559/10 1793 Dec 5 13:02 1986 

r—r—r— 559/10 5783 Dec 5 13:02 1986 

rwxrwxrwx 0/10 0 Dec 5 20:57 1986 

rwxrwxrwx 0/10 0 Dec 5 20:56 1986 

r—r—r— 559/10 2413 Dec 5 13:02 1986 

r—r—r— 559/10 2684 Dec 5 13:02 1986 

r—r — r— 559/10 905 Dec 5 13:02 1986 

rwxrwxrwx 0/10 0 Dec 5 20:57 1986 

rwxrwxrwx 0/10 0 Dec 5 20:57 1986 

r—r—r— 559/10 3452 Dec 5 13:03 1986 

r—r—r— 559/10 13885 Dec 5 13:02 1986 

r—r — r— 559/10 6197 Dec 5 13:02 1986 

r—r—r— 559/10 1415 Dec 5 13:02 1986 

r—r—r— 559/10 1482 Dec 5 13:02 1986 

r—r — r— 559/10 3514 Dec 5 13:02 1986 

r—r—r— 559/10 3186 Dec 5 13:02 1986 

r—r—r— 559/10 995 Dec 5 13:02 1986 

r—r—r— 559/10 3491 Dec 5 13:02 1986 

r—r—r— 559/10 1057 Dec 5 13:02 1986 

r—r — r— 559/10 1514 Dec 5 13:02 1986 

r—r — r— 559/10 2542 Dec 5 13:02 1986 

r—r—r— 559/10 1968 Dec 5 13:02 1986 

r—r—r— 559/10 1317 Dec 5 13:03 1986 

r—r—r— 559/10 1129 Dec 5 13:03 1986 

r—r—r— 559/10 1127 Dec 5 13:03 1986 

r—r — r— 559/10 1340 Dec 5 13:03 1986 

r—r—r— 559/10 3397 Dec 5 13:03 1986 

r—r—r— 559/10 1988 Dec 5 13:03 1986 

r—r—r— 559/10 2625 Dec 5 13:03 1986 

r — r — r —559/10 1516 Dec 5 13:03 1986 

rwxrwxrwx 0/10 0 Dec 5 20:57 1986 

rwxrwxrwx 0/10 0 Dec 5 20:57 1986 

r—r—r— 559/10 2683 Dec 5 13:03 1986 

r—r — r —559/10 1410 Dec 5 13:03 1986 

r— r—r— 559/ 10 1361 Dec 5 13:03 1986 

r— r — r —559/10 1041 Dec 5 13:03 1986 

c—r—r—559/10 1100 Dec 5 13:03 1986 

r—r—r— 559/10 920 Dec 5 13:03 1986 

r—r — r— 559/10 1884 Dec 5 13:03 1986 

r— r— r —559/10 1502 Dec 5 13:03 1986 

r — r — r —559/10 1119 Dec 5 13:03 1986 

r — r —r—559/10 1275 Dec 5 13:03 1986 

r — r — r —559/10 1296 Dec 5 13:03 1986 

r —r — r —559/10 1182 Dec 5 13:03 1986 

r— r — r— 559/10 1991 Dec 5 13:04 1986 

rwxr-xr-x 0/10 0 Dec 5 20:57 1986 

rwxrwxrwx 0/10 0 Dec 5 20:57 1986 

r— r — r— 559/10 2285 Dec 5 13:06 1986 

r— r — r —559/10 8169 Dec 5 13:06 1986 

c— r — r— 559/10 1196 Dec 5 13:06 1986 

r—r —r—559/10 2903 Dec 5 13:06 1986 

r—r—r— 559/10 4415 Dec 5 13:06 1986 

r— r — r —559/10 27378 Dec 5 17:20 1986 

r—r—r— 559/10 3600 Dec 5 13:07 1986 

c—r— r —559/10 7642 Dec 5 13:07 1986 

r— r — r —559/10 3332 Dec 5 13:06 1986 

r—r—r— 559/10 5437 Dec 5 13:07 1986 

r—r—r—559/10 5317 Dec 5 13:07 1986 

r—r—r— 559/10 7264 Dec 5 13:06 1986 

r—r—r— 559/10 6827 Dec 5 13:07 1986 

r—r—r— 559/10 2990 Dec 5 13:07 1986 

r—r—r— 559/10 2483 Dec 5 13:07 1986 

r—r—r— 559/10 827 Dec 5 13:06 1986 

:—r—r—559/10 6723 Dec 5 13:06 1986 


/usr/pixar/host/src/lib/libpixar/mctrlreg. 
/usr/pixar/host/src/lib/libpixar/yumi.c 
/usr/pixar/host/src/lib/libpixar/yumioctl. 
/usr/pixar/host/src/lib/libpixar/yumireg.h 
/usr/pixar/host/src/lib/libcolr/ 

/usr/pixar/host/src/lib/libcolr/profiled/ 
/usr/pixar/host/src/lib/libcolr/Makefile 
/usr/pixar/host/src/lib/libcolr/RgbToHsv.c 
/usr/pixar/host/src/lib/libcolr/coir.h 
/usr/pixar/host/src/lib/librG/ 

/usr/pixar/host/src/lib/librG/profiled/ 
/usr/pixar/host/src/lib/librG/Makefile 
/usr/pixar/host/src/lib/librG/fbdefs.c 
/usr/pixar/host/src/lib/librG/drand.c 
/usr/pixar/host/src/lib/librG/fbaarg.h 
/usr/pixar/host/src/lib/librG/fbdefs.h 
/usr/pixar/host/src/lib/librG/isqrt.c 
/usr/pixar/host/src/lib/librG/random.c 
/usr/pixar/host/src/lib/librG/random.h 
/usr/pixar/host/src/lib/librG/rrand.c 
/usr/pixar/host/src/lib/librG/rrand.h 
/usr/pixar/host/src/lib/librG/wallinterval 
/usr/pixar/host/src/lib/librG/aa_fb.c 
/usr/pixar/host/src/lib/librG/aa_setcolor. 
/usr/pixar/host/src/lib/librG/environ.h 
/usr/pixar/host/src/lib/librG/coloraarg.h 
/usr/pixar/host/src/lib/librG/constants.h 
/usr/pixar/host/src/lib/librG/math.h 
/usr/pixar/host/src/lib/librG/gfxtypes.h 
/usr/pixar/host/src/lib/librG/pixwin.h 
/usr/pixar/host/src/lib/librG/LineDraw.c 
/usr/pixar/host/src/lib/librG/pixeldef.h 
/usr/pixar/host/src/lib/libport/ 

/usr/pixar/host/src/lib/libport/profiled/ 
/usr/pixar/host/src/lib/libport/Makefile 
/usr/pixar/host/src/lib/libport/ffs.c 
/usr/pixar/host/src/lib/libport/flock.c 
/usr/pixar/host/src/lib/libport/fork.c 
/usr/pixar/host/src/lib/libport/getpagesiz 
/usr/pixar/host/src/lib/libport/random.c 
/usr/pixar/host/src/lib/libport/readv.c 
/usr/pixar/host/src/lib/libport/rename.c 
/usr/pixar/host/src/lib/libport/setlinebuf 
/usr/pixar/host/src/lib/libport/uio.h 
/usr/pixar/host/src/lib/libport/valloc.c 
/usr/pixar/host/src/lib/libport/filestuff. 
/usr/pixar/host/src/lib/Makefile 
/usr/pixar/host/src/bin/ 

/usr/pixar/host/src/bin/loop/ 

/usr/pixar/host/src/bin/loop/Makefile 
/usr/pixar/host/src/bin/loop/loop.c 
/usr/pixar/host/src/bin/loop/loop.h 
/usr/pixar/host/src/bin/loop/nap.c 
/usr/pixar/host/src/bin/loop/poll.c 
/usr/pixar/host/src/bin/Makefile 
/usr/pixar/host/src/bin/MxMatrix.h 
/usr/pixar/host/src/bin/blur.c 
/usr/pixar/host/src/bin/cbars.c 
/usr/pixar/host/src/bin/clamp.c 
/usr/pixar/host/src/bin/clr.c 
/usr/pixar/host/src/bin/conv.c 
/usr/pixar/host/src/bin/copy.c 
/usr/pixar/host/src/bin/crc.c 
/usr/pixar/host/src/bin/cursor.h 
/usr/pixar/host/src/bin/gamma.sh 
/usr/pixar/host/src/bin/gt.c 
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/usr/pixar/host/src/bin/gtinfo.c 
/usr/pixar/host/src/bin/guide.c 
/usr/pixar/host/src/bin/hg.c 
/usr/pixar/host/src/bin/malloc.c 
/usr/pixar/host/src/bin/mctrl.c 
/usr/pixar/host/src/bin/merge.c 
/usr/pixar/host/src/bin/perm.c 
/usr/pixar/host/src/bin/pixinit.sh 
/usr/pixar/host/src/bin/ramp.c 
/usr/pixar/host/src/bin/resize.c 
/usr/pixar/host/src/bin/rotate.c 
/usr/pixar/host/src/bin/scale.c 
/usr/pixar/host/src/bin/see.c 
/usr/pixar/host/src/bin/sv.c 
/usr/pixar/host/src/bin/tool.c 
/usr/pixar/host/src/bin/video.c 
/usr/pixar/host/src/bin/video.gammamaps.h 
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rwxr-xr-x 0/10 0 Dec 4 18:16 1986 /usr/pixar/ 

rwxr-xr-x 0/10 0 Dec 4 18:06 1986 /usr/pixar/demo/ 

rwxr-xr-x 0/10 0 Dec 4 18:14 1986 /usr/pixar/demo/pix/ 

rw-r—r— 0/10 135 Dec 3 17:00 1986 /usr/pixar/demo/pix/README 

r—r—r— 0/107340032 Dec 3 16:09 1986 /■usr/pixar/demo/pix/antenna.half 

r—r—r— 0/1012722176 Dec 3 16:14 1986 /usr/pixar/demo/pix/awb.loop 

r—r—r— 0/101990656 Dec 3 16:09 1986 /usr/pixar/demo/pix/fft.screen 

rw-r—r— 0/0 217 Dec 4 18:16 1986 /usr/pixar/Verify.picl 
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rwxr-xr-x 
rwxr-xr-x 
rwxr-xr-x 
rw-r—r — 
r—r—r— 
r—r—r — 
rwxr-xr-x 
r—r—r — 
r—r—r— 
r—r—r— 
rw-r—r— 


0/10 0 Dec 4 18:32 1986 /usr/pixar/ 

0/10 0 Dec 4 18:21 1986 /usr/pixar/demo/ 

0/10 0 Dec 4 18:27 1986 /usr/pixar/demo/pix/ 

0/10 135 Dec 3 17:00 1986 /usr/pixar/demo/pix/README 

0/102547712 Dec 3 16:14 1986 /usr/pixar/demo/pix/1984 
0/1012673024 Dec 3 16:11 1986 /usr/pixar/demo/pix/fruit.4M 
0/10 0 Dec 4 18:30 1986 /usr/pixar/demo/pix/trees/ 

0/10 802816 Dec 3 16:14 1986 /usr/pixar/demo/pix/trees/trees.comp 

0/104792320 Dec 3 16:16 1986 /usr/pixar/demo/pix/trees/trees.elm 
0/10 696320 Dec 3 16:16 1986 /usr/pixar/demo/pix/trees/trees.bckgrnd 
0/0 339 Dec 4 18:31 1986 /usr/pixar/Verify.pic2 








